[{"data":1,"prerenderedAt":3693},["ShallowReactive",2],{"navigation":3,"\u002Fservices\u002Fjoins":927,"mdc--qbu9ap-key":3643,"mdc--a4qin1-key":3666,"mdc--g2cis1-key":3684},[4,40,114,446,474,498,596,903],{"title":5,"path":6,"stem":7,"children":8},"Architecture","\u002Farchitecture","architecture",[9,14,28,32,36],{"title":10,"path":6,"stem":11,"access":12,"icon":13},"Overview","architecture\u002Findex","public","i-lucide-network",{"title":10,"path":15,"stem":16,"children":17,"access":12,"icon":19},"\u002Farchitecture\u002Fkernel","architecture\u002F1.kernel\u002Findex",[18,20,24],{"title":10,"path":15,"stem":16,"access":12,"icon":19},"i-lucide-box",{"title":21,"path":22,"stem":23,"access":12},"Enclave","\u002Farchitecture\u002Fkernel\u002Fenclave","architecture\u002F1.kernel\u002Fenclave",{"title":25,"path":26,"stem":27,"access":12},"Forking the enclave","\u002Farchitecture\u002Fkernel\u002Fforking-the-enclave","architecture\u002F1.kernel\u002Fforking-the-enclave",{"title":29,"path":30,"stem":31,"access":12},"Ports","\u002Farchitecture\u002Fports","architecture\u002F2.ports",{"title":33,"path":34,"stem":35,"access":12},"Service layers","\u002Farchitecture\u002Fservice-layers","architecture\u002F3.service-layers",{"title":37,"path":38,"stem":39,"access":12},"Families","\u002Farchitecture\u002Ffamilies","architecture\u002F4.families",{"title":41,"path":42,"stem":43,"children":44},"Core","\u002Fcore","core",[45,47,50,53,56,88,97],{"title":10,"path":42,"stem":46,"access":12,"icon":19},"core\u002Findex",{"title":10,"path":48,"stem":49,"access":12},"\u002Fcore\u002F01-overview","core\u002F01-overview",{"title":10,"path":51,"stem":52,"access":12},"\u002Fcore\u002F05-stores","core\u002F05-stores",{"title":10,"path":54,"stem":55,"access":12},"\u002Fcore\u002F06-permissions-and-keyring","core\u002F06-permissions-and-keyring",{"title":10,"path":57,"stem":58,"children":59,"access":12},"\u002Fcore\u002Fnoydb","core\u002F2.noydb\u002Findex",[60,61,65,68,72,76,80,84],{"title":10,"path":57,"stem":58,"access":12},{"title":62,"path":63,"stem":64,"access":12},"Noydb","\u002Fcore\u002Fnoydb\u002Fmethods","core\u002F2.noydb\u002F1.methods",{"title":21,"path":66,"stem":67,"access":12},"\u002Fcore\u002Fnoydb\u002Fenclave","core\u002F2.noydb\u002F2.enclave",{"title":69,"path":70,"stem":71,"access":12},"Secret & keyring","\u002Fcore\u002Fnoydb\u002Fkeyring","core\u002F2.noydb\u002F3.keyring",{"title":73,"path":74,"stem":75,"access":12},"Authentication","\u002Fcore\u002Fnoydb\u002Fauthentication","core\u002F2.noydb\u002F4.authentication",{"title":77,"path":78,"stem":79,"access":12},"Auth recovery","\u002Fcore\u002Fnoydb\u002Frecovery","core\u002F2.noydb\u002F5.recovery",{"title":81,"path":82,"stem":83,"access":12},"Configuration","\u002Fcore\u002Fnoydb\u002Fconfiguration","core\u002F2.noydb\u002F6.configuration",{"title":85,"path":86,"stem":87,"access":12},"Strategies","\u002Fcore\u002Fnoydb\u002Fstrategies","core\u002F2.noydb\u002F7.strategies",{"title":10,"path":89,"stem":90,"children":91,"access":12},"\u002Fcore\u002Fvault","core\u002F3.vault\u002Findex",[92,93],{"title":10,"path":89,"stem":90,"access":12},{"title":94,"path":95,"stem":96,"access":12},"Vault","\u002Fcore\u002Fvault\u002Fmethods","core\u002F3.vault\u002F1.methods",{"title":10,"path":98,"stem":99,"children":100,"access":12},"\u002Fcore\u002Fcollection","core\u002F4.collection\u002Findex",[101,102,106,110],{"title":10,"path":98,"stem":99,"access":12},{"title":103,"path":104,"stem":105,"access":12},"Collection","\u002Fcore\u002Fcollection\u002Fmethods","core\u002F4.collection\u002F1.methods",{"title":107,"path":108,"stem":109,"access":12},"Querying","\u002Fcore\u002Fcollection\u002Fquerying","core\u002F4.collection\u002F2.querying",{"title":111,"path":112,"stem":113,"access":12},"Schema","\u002Fcore\u002Fcollection\u002Fschema","core\u002F4.collection\u002F3.schema",{"title":37,"path":115,"stem":116,"children":117},"\u002Ffamilies","families",[118,121,168,194,208,212,216,294,340],{"title":10,"path":115,"stem":119,"access":12,"icon":120},"families\u002Findex","i-lucide-plug",{"title":122,"path":123,"stem":124,"children":125,"access":12,"icon":127},"as-Exports","\u002Ffamilies\u002Fas","families\u002Fas\u002Findex",[126,128,132,136,140,144,148,152,156,160,164],{"title":122,"path":123,"stem":124,"access":12,"icon":127},"i-lucide-book-open",{"title":129,"path":130,"stem":131,"access":12},"aws-s3","\u002Ffamilies\u002Fas\u002Faws-s3","families\u002Fas\u002Faws-s3",{"title":133,"path":134,"stem":135,"access":12},"blob","\u002Ffamilies\u002Fas\u002Fblob","families\u002Fas\u002Fblob",{"title":137,"path":138,"stem":139,"access":12},"csv","\u002Ffamilies\u002Fas\u002Fcsv","families\u002Fas\u002Fcsv",{"title":141,"path":142,"stem":143,"access":12},"json","\u002Ffamilies\u002Fas\u002Fjson","families\u002Fas\u002Fjson",{"title":145,"path":146,"stem":147,"access":12},"ndjson","\u002Ffamilies\u002Fas\u002Fndjson","families\u002Fas\u002Fndjson",{"title":149,"path":150,"stem":151,"access":12},"noydb","\u002Ffamilies\u002Fas\u002Fnoydb","families\u002Fas\u002Fnoydb",{"title":153,"path":154,"stem":155,"access":12},"sql","\u002Ffamilies\u002Fas\u002Fsql","families\u002Fas\u002Fsql",{"title":157,"path":158,"stem":159,"access":12},"xlsx","\u002Ffamilies\u002Fas\u002Fxlsx","families\u002Fas\u002Fxlsx",{"title":161,"path":162,"stem":163,"access":12},"xml","\u002Ffamilies\u002Fas\u002Fxml","families\u002Fas\u002Fxml",{"title":165,"path":166,"stem":167,"access":12},"zip","\u002Ffamilies\u002Fas\u002Fzip","families\u002Fas\u002Fzip",{"title":169,"path":170,"stem":171,"children":172,"access":12,"icon":127},"at-Seals","\u002Ffamilies\u002Fat","families\u002Fat\u002Findex",[173,174,178,182,186,190],{"title":169,"path":170,"stem":171,"access":12,"icon":127},{"title":175,"path":176,"stem":177,"access":12},"aws-kms","\u002Ffamilies\u002Fat\u002Faws-kms","families\u002Fat\u002Faws-kms",{"title":179,"path":180,"stem":181,"access":12},"azure-keyvault","\u002Ffamilies\u002Fat\u002Fazure-keyvault","families\u002Fat\u002Fazure-keyvault",{"title":183,"path":184,"stem":185,"access":12},"env","\u002Ffamilies\u002Fat\u002Fenv","families\u002Fat\u002Fenv",{"title":187,"path":188,"stem":189,"access":12},"gcp-kms","\u002Ffamilies\u002Fat\u002Fgcp-kms","families\u002Fat\u002Fgcp-kms",{"title":191,"path":192,"stem":193,"access":12},"macos-keychain","\u002Ffamilies\u002Fat\u002Fmacos-keychain","families\u002Fat\u002Fmacos-keychain",{"title":195,"path":196,"stem":197,"children":198,"access":12,"icon":127},"by-Sessions","\u002Ffamilies\u002Fby","families\u002Fby\u002Findex",[199,200,204],{"title":195,"path":196,"stem":197,"access":12,"icon":127},{"title":201,"path":202,"stem":203,"access":12},"peer","\u002Ffamilies\u002Fby\u002Fpeer","families\u002Fby\u002Fpeer",{"title":205,"path":206,"stem":207,"access":12},"tabs","\u002Ffamilies\u002Fby\u002Ftabs","families\u002Fby\u002Ftabs",{"title":209,"path":210,"stem":211,"access":12},"Classifying a package","\u002Ffamilies\u002Fclassification","families\u002Fclassification",{"title":213,"path":214,"stem":215,"access":12},"Command-line tools","\u002Ffamilies\u002Fcli","families\u002Fcli",{"title":217,"path":218,"stem":219,"children":220,"access":12,"icon":127},"in-Frameworks","\u002Ffamilies\u002Fin","families\u002Fin\u002Findex",[221,222,226,230,234,238,242,246,250,254,258,262,266,270,274,278,282,286,290],{"title":217,"path":218,"stem":219,"access":12,"icon":127},{"title":223,"path":224,"stem":225,"access":12},"ai","\u002Ffamilies\u002Fin\u002Fai","families\u002Fin\u002Fai",{"title":227,"path":228,"stem":229,"access":12},"devtools","\u002Ffamilies\u002Fin\u002Fdevtools","families\u002Fin\u002Fdevtools",{"title":231,"path":232,"stem":233,"access":12},"devtools-tui","\u002Ffamilies\u002Fin\u002Fdevtools-tui","families\u002Fin\u002Fdevtools-tui",{"title":235,"path":236,"stem":237,"access":12},"liff","\u002Ffamilies\u002Fin\u002Fliff","families\u002Fin\u002Fliff",{"title":239,"path":240,"stem":241,"access":12},"nextjs","\u002Ffamilies\u002Fin\u002Fnextjs","families\u002Fin\u002Fnextjs",{"title":243,"path":244,"stem":245,"access":12},"nuxt","\u002Ffamilies\u002Fin\u002Fnuxt","families\u002Fin\u002Fnuxt",{"title":247,"path":248,"stem":249,"access":12},"pinia","\u002Ffamilies\u002Fin\u002Fpinia","families\u002Fin\u002Fpinia",{"title":251,"path":252,"stem":253,"access":12},"pwa","\u002Ffamilies\u002Fin\u002Fpwa","families\u002Fin\u002Fpwa",{"title":255,"path":256,"stem":257,"access":12},"react","\u002Ffamilies\u002Fin\u002Freact","families\u002Fin\u002Freact",{"title":259,"path":260,"stem":261,"access":12},"relay","\u002Ffamilies\u002Fin\u002Frelay","families\u002Fin\u002Frelay",{"title":263,"path":264,"stem":265,"access":12},"rest","\u002Ffamilies\u002Fin\u002Frest","families\u002Fin\u002Frest",{"title":267,"path":268,"stem":269,"access":12},"solid","\u002Ffamilies\u002Fin\u002Fsolid","families\u002Fin\u002Fsolid",{"title":271,"path":272,"stem":273,"access":12},"svelte","\u002Ffamilies\u002Fin\u002Fsvelte","families\u002Fin\u002Fsvelte",{"title":275,"path":276,"stem":277,"access":12},"tanstack-query","\u002Ffamilies\u002Fin\u002Ftanstack-query","families\u002Fin\u002Ftanstack-query",{"title":279,"path":280,"stem":281,"access":12},"tanstack-table","\u002Ffamilies\u002Fin\u002Ftanstack-table","families\u002Fin\u002Ftanstack-table",{"title":283,"path":284,"stem":285,"access":12},"vue","\u002Ffamilies\u002Fin\u002Fvue","families\u002Fin\u002Fvue",{"title":287,"path":288,"stem":289,"access":12},"yjs","\u002Ffamilies\u002Fin\u002Fyjs","families\u002Fin\u002Fyjs",{"title":291,"path":292,"stem":293,"access":12},"zustand","\u002Ffamilies\u002Fin\u002Fzustand","families\u002Fin\u002Fzustand",{"title":295,"path":296,"stem":297,"children":298,"access":12,"icon":127},"on-Auth","\u002Ffamilies\u002Fon","families\u002Fon\u002Findex",[299,300,304,308,312,316,320,324,328,332,336],{"title":295,"path":296,"stem":297,"access":12,"icon":127},{"title":301,"path":302,"stem":303,"access":12},"email-otp","\u002Ffamilies\u002Fon\u002Femail-otp","families\u002Fon\u002Femail-otp",{"title":305,"path":306,"stem":307,"access":12},"magic-link","\u002Ffamilies\u002Fon\u002Fmagic-link","families\u002Fon\u002Fmagic-link",{"title":309,"path":310,"stem":311,"access":12},"oidc","\u002Ffamilies\u002Fon\u002Foidc","families\u002Fon\u002Foidc",{"title":313,"path":314,"stem":315,"access":12},"password","\u002Ffamilies\u002Fon\u002Fpassword","families\u002Fon\u002Fpassword",{"title":317,"path":318,"stem":319,"access":12},"pin","\u002Ffamilies\u002Fon\u002Fpin","families\u002Fon\u002Fpin",{"title":321,"path":322,"stem":323,"access":12},"recovery","\u002Ffamilies\u002Fon\u002Frecovery","families\u002Fon\u002Frecovery",{"title":325,"path":326,"stem":327,"access":12},"shamir","\u002Ffamilies\u002Fon\u002Fshamir","families\u002Fon\u002Fshamir",{"title":329,"path":330,"stem":331,"access":12},"threat","\u002Ffamilies\u002Fon\u002Fthreat","families\u002Fon\u002Fthreat",{"title":333,"path":334,"stem":335,"access":12},"totp","\u002Ffamilies\u002Fon\u002Ftotp","families\u002Fon\u002Ftotp",{"title":337,"path":338,"stem":339,"access":12},"webauthn","\u002Ffamilies\u002Fon\u002Fwebauthn","families\u002Fon\u002Fwebauthn",{"title":341,"path":342,"stem":343,"children":344,"access":12,"icon":127},"to-Stores","\u002Ffamilies\u002Fto","families\u002Fto\u002Findex",[345,346,350,353,357,361,365,370,374,378,382,386,390,394,398,402,406,410,414,417,421,425,429,434,438,442],{"title":341,"path":342,"stem":343,"access":12,"icon":127},{"title":347,"path":348,"stem":349,"access":12},"aws-dynamo","\u002Ffamilies\u002Fto\u002Faws-dynamo","families\u002Fto\u002Faws-dynamo",{"title":129,"path":351,"stem":352,"access":12},"\u002Ffamilies\u002Fto\u002Faws-s3","families\u002Fto\u002Faws-s3",{"title":354,"path":355,"stem":356,"access":12},"browser-fs","\u002Ffamilies\u002Fto\u002Fbrowser-fs","families\u002Fto\u002Fbrowser-fs",{"title":358,"path":359,"stem":360,"access":12},"browser-idb","\u002Ffamilies\u002Fto\u002Fbrowser-idb","families\u002Fto\u002Fbrowser-idb",{"title":362,"path":363,"stem":364,"access":12},"browser-local","\u002Ffamilies\u002Fto\u002Fbrowser-local","families\u002Fto\u002Fbrowser-local",{"title":366,"path":367,"stem":368,"access":12,"icon":369},"Choosing a store","\u002Ffamilies\u002Fto\u002Fchoosing-a-store","families\u002Fto\u002Fchoosing-a-store","i-lucide-split",{"title":371,"path":372,"stem":373,"access":12},"cloudflare-d1","\u002Ffamilies\u002Fto\u002Fcloudflare-d1","families\u002Fto\u002Fcloudflare-d1",{"title":375,"path":376,"stem":377,"access":12},"cloudflare-r2","\u002Ffamilies\u002Fto\u002Fcloudflare-r2","families\u002Fto\u002Fcloudflare-r2",{"title":379,"path":380,"stem":381,"access":12},"drive","\u002Ffamilies\u002Fto\u002Fdrive","families\u002Fto\u002Fdrive",{"title":383,"path":384,"stem":385,"access":12},"file","\u002Ffamilies\u002Fto\u002Ffile","families\u002Fto\u002Ffile",{"title":387,"path":388,"stem":389,"access":12},"icloud","\u002Ffamilies\u002Fto\u002Ficloud","families\u002Fto\u002Ficloud",{"title":391,"path":392,"stem":393,"access":12},"memory","\u002Ffamilies\u002Fto\u002Fmemory","families\u002Fto\u002Fmemory",{"title":395,"path":396,"stem":397,"access":12},"meter","\u002Ffamilies\u002Fto\u002Fmeter","families\u002Fto\u002Fmeter",{"title":399,"path":400,"stem":401,"access":12},"mysql","\u002Ffamilies\u002Fto\u002Fmysql","families\u002Fto\u002Fmysql",{"title":403,"path":404,"stem":405,"access":12},"nfs","\u002Ffamilies\u002Fto\u002Fnfs","families\u002Fto\u002Fnfs",{"title":407,"path":408,"stem":409,"access":12},"postgres","\u002Ffamilies\u002Fto\u002Fpostgres","families\u002Fto\u002Fpostgres",{"title":411,"path":412,"stem":413,"access":12},"probe","\u002Ffamilies\u002Fto\u002Fprobe","families\u002Fto\u002Fprobe",{"title":263,"path":415,"stem":416,"access":12},"\u002Ffamilies\u002Fto\u002Frest","families\u002Fto\u002Frest",{"title":418,"path":419,"stem":420,"access":12},"smb","\u002Ffamilies\u002Fto\u002Fsmb","families\u002Fto\u002Fsmb",{"title":422,"path":423,"stem":424,"access":12},"sqlite","\u002Ffamilies\u002Fto\u002Fsqlite","families\u002Fto\u002Fsqlite",{"title":426,"path":427,"stem":428,"access":12},"ssh","\u002Ffamilies\u002Fto\u002Fssh","families\u002Fto\u002Fssh",{"title":430,"path":431,"stem":432,"access":12,"icon":433},"Store-locator descriptors","\u002Ffamilies\u002Fto\u002Fstore-locator","families\u002Fto\u002Fstore-locator","i-lucide-map-pin",{"title":435,"path":436,"stem":437,"access":12},"supabase","\u002Ffamilies\u002Fto\u002Fsupabase","families\u002Fto\u002Fsupabase",{"title":439,"path":440,"stem":441,"access":12},"turso","\u002Ffamilies\u002Fto\u002Fturso","families\u002Fto\u002Fturso",{"title":443,"path":444,"stem":445,"access":12},"webdav","\u002Ffamilies\u002Fto\u002Fwebdav","families\u002Fto\u002Fwebdav",{"title":447,"path":448,"stem":449,"children":450},"Faq","\u002Ffaq","faq",[451,454,458,462,466,470],{"title":10,"path":448,"stem":452,"access":12,"icon":453},"faq\u002Findex","i-lucide-circle-help",{"title":455,"path":456,"stem":457,"access":12},"Where can noy-db run?","\u002Ffaq\u002Fwhere-can-noy-db-run","faq\u002F1.where-can-noy-db-run",{"title":459,"path":460,"stem":461,"access":12},"Native mobile & PWA","\u002Ffaq\u002Fmobile-and-pwa","faq\u002F2.mobile-and-pwa",{"title":463,"path":464,"stem":465,"access":12},"Threat model","\u002Ffaq\u002Fthreat-model","faq\u002F3.threat-model",{"title":467,"path":468,"stem":469,"access":12},"Community & ecosystem","\u002Ffaq\u002Fcommunity-and-ecosystem","faq\u002F4.community-and-ecosystem",{"title":471,"path":472,"stem":473,"access":12},"Licensing","\u002Ffaq\u002Flicensing","faq\u002F5.licensing",{"title":475,"path":476,"stem":477,"children":478},"Glossary","\u002Fglossary","glossary",[479,482,486,490,494],{"title":10,"path":476,"stem":480,"access":12,"icon":481},"glossary\u002Findex","i-lucide-book-a",{"title":483,"path":484,"stem":485,"access":12},"Core vocabulary","\u002Fglossary\u002Fcore-vocabulary","glossary\u002Fcore-vocabulary",{"title":487,"path":488,"stem":489,"access":12},"Deletion vocabulary","\u002Fglossary\u002Fdeletion","glossary\u002Fdeletion",{"title":491,"path":492,"stem":493,"access":12},"Satellite collection vocabulary","\u002Fglossary\u002Fsatellite-collections","glossary\u002Fsatellite-collections",{"title":495,"path":496,"stem":497,"access":12},"Schema migration vocabulary","\u002Fglossary\u002Fschema-migration","glossary\u002Fschema-migration",{"title":499,"path":500,"stem":501,"children":502},"Recipes","\u002Frecipes","recipes",[503,506,510,514,518,522,526,530,534,538,542,546,550,554,558,562,567,571,575,580,584,588,592],{"title":10,"path":500,"stem":504,"access":12,"icon":505},"recipes\u002Findex","i-lucide-play",{"title":507,"path":508,"stem":509,"access":12},"Accounting app","\u002Frecipes\u002Faccounting-app","recipes\u002Faccounting-app",{"title":511,"path":512,"stem":513,"access":12},"Analytics app","\u002Frecipes\u002Fanalytics-app","recipes\u002Fanalytics-app",{"title":515,"path":516,"stem":517,"access":12},"Attestation verifier","\u002Frecipes\u002Fattestation-verifier","recipes\u002Fattestation-verifier",{"title":519,"path":520,"stem":521,"access":12},"AWS-KMS attestation","\u002Frecipes\u002Faws-kms-pdf-attestation","recipes\u002Faws-kms-pdf-attestation",{"title":523,"path":524,"stem":525,"access":12},"Browser durability","\u002Frecipes\u002Fbrowser-durability","recipes\u002Fbrowser-durability",{"title":527,"path":528,"stem":529,"access":12},"Production cloud store","\u002Frecipes\u002Fcloud-store","recipes\u002Fcloud-store",{"title":531,"path":532,"stem":533,"access":12},"Compose your own setup","\u002Frecipes\u002Fcompose-your-own","recipes\u002Fcompose-your-own",{"title":535,"path":536,"stem":537,"access":12},"Confidential HR records","\u002Frecipes\u002Fconfidential-hr","recipes\u002Fconfidential-hr",{"title":539,"path":540,"stem":541,"access":12},"Composing an echo secret","\u002Frecipes\u002Fecho-secret-enrollment","recipes\u002Fecho-secret-enrollment",{"title":543,"path":544,"stem":545,"access":12},"Email archive","\u002Frecipes\u002Femail-archive","recipes\u002Femail-archive",{"title":547,"path":548,"stem":549,"access":12},"Email archive — threads & revisions","\u002Frecipes\u002Femail-archive-threads-revisions","recipes\u002Femail-archive-threads-revisions",{"title":551,"path":552,"stem":553,"access":12},"Export & portability","\u002Frecipes\u002Fexport-portability","recipes\u002Fexport-portability",{"title":555,"path":556,"stem":557,"access":12},"Passwordless OIDC (AWS Cognito)","\u002Frecipes\u002Fpasswordless-oidc","recipes\u002Fpasswordless-oidc",{"title":559,"path":560,"stem":561,"access":12},"Personal notebook","\u002Frecipes\u002Fpersonal-notebook","recipes\u002Fpersonal-notebook",{"title":563,"path":564,"stem":565,"access":12,"icon":566},"Playgrounds","\u002Frecipes\u002Fplaygrounds","recipes\u002Fplaygrounds","i-lucide-gamepad-2",{"title":568,"path":569,"stem":570,"access":12},"React invoice app","\u002Frecipes\u002Freact-invoices","recipes\u002Freact-invoices",{"title":572,"path":573,"stem":574,"access":12},"Collaborative app","\u002Frecipes\u002Frealtime-crdt-app","recipes\u002Frealtime-crdt-app",{"title":576,"path":577,"stem":578,"access":12,"icon":579},"Run the showcases","\u002Frecipes\u002Frun-the-showcases","recipes\u002Frun-the-showcases","i-lucide-flask-conical",{"title":581,"path":582,"stem":583,"access":12},"Search & RAG","\u002Frecipes\u002Fsearch-rag","recipes\u002Fsearch-rag",{"title":585,"path":586,"stem":587,"access":12},"Team vault topology","\u002Frecipes\u002Fteam-vault-topology","recipes\u002Fteam-vault-topology",{"title":589,"path":590,"stem":591,"access":12},"Unlock ceremonies","\u002Frecipes\u002Funlock-ceremonies","recipes\u002Funlock-ceremonies",{"title":593,"path":594,"stem":595,"access":12},"User preferences","\u002Frecipes\u002Fuser-preferences","recipes\u002Fuser-preferences",{"title":597,"path":598,"stem":599,"children":600},"Services","\u002Fservices","services",[601,604,608,612,616,620,624,628,632,636,640,644,648,652,656,660,664,668,672,676,680,684,688,692,696,700,704,710,714,718,722,726,730,734,738,742,746,750,755,759,763,767,771,775,779,783,787,791,795,799,803,807,811,815,819,823,827,831,835,839,843,847,851,855,859,863,867,871,875,879,883,887,891,895,899],{"title":10,"path":598,"stem":602,"access":12,"icon":603},"services\u002Findex","i-lucide-layers",{"title":605,"path":606,"stem":607,"access":12},"archive","\u002Fservices\u002Farchive","services\u002Farchive",{"title":609,"path":610,"stem":611,"access":12},"attestation","\u002Fservices\u002Fattestation","services\u002Fattestation",{"title":613,"path":614,"stem":615,"access":12},"auth-introspection","\u002Fservices\u002Fauth-introspection","services\u002Fauth-introspection",{"title":617,"path":618,"stem":619,"access":12},"auth-landscape","\u002Fservices\u002Fauth-landscape","services\u002Fauth-landscape",{"title":621,"path":622,"stem":623,"access":12},"blobs","\u002Fservices\u002Fblobs","services\u002Fblobs",{"title":625,"path":626,"stem":627,"access":12},"broker","\u002Fservices\u002Fbroker","services\u002Fbroker",{"title":629,"path":630,"stem":631,"access":12},"bundle","\u002Fservices\u002Fbundle","services\u002Fbundle",{"title":633,"path":634,"stem":635,"access":12},"classified","\u002Fservices\u002Fclassified","services\u002Fclassified",{"title":637,"path":638,"stem":639,"access":12},"computed","\u002Fservices\u002Fcomputed","services\u002Fcomputed",{"title":641,"path":642,"stem":643,"access":12},"consent","\u002Fservices\u002Fconsent","services\u002Fconsent",{"title":645,"path":646,"stem":647,"access":12},"cover","\u002Fservices\u002Fcover","services\u002Fcover",{"title":649,"path":650,"stem":651,"access":12},"coverage","\u002Fservices\u002Fcoverage","services\u002Fcoverage",{"title":653,"path":654,"stem":655,"access":12},"crdt","\u002Fservices\u002Fcrdt","services\u002Fcrdt",{"title":657,"path":658,"stem":659,"access":12},"cross-join","\u002Fservices\u002Fcross-join","services\u002Fcross-join",{"title":661,"path":662,"stem":663,"access":12},"custody","\u002Fservices\u002Fcustody","services\u002Fcustody",{"title":665,"path":666,"stem":667,"access":12},"derivations","\u002Fservices\u002Fderivations","services\u002Fderivations",{"title":669,"path":670,"stem":671,"access":12},"directory","\u002Fservices\u002Fdirectory","services\u002Fdirectory",{"title":673,"path":674,"stem":675,"access":12},"search — AI","\u002Fservices\u002Fembeddings","services\u002Fembeddings",{"title":677,"path":678,"stem":679,"access":12},"Field metadata","\u002Fservices\u002Ffield-metadata","services\u002Ffield-metadata",{"title":681,"path":682,"stem":683,"access":12},"Foreign refs","\u002Fservices\u002Fforeign-refs","services\u002Fforeign-refs",{"title":685,"path":686,"stem":687,"access":12},"forget","\u002Fservices\u002Fforget","services\u002Fforget",{"title":689,"path":690,"stem":691,"access":12},"governance","\u002Fservices\u002Fgovernance","services\u002Fgovernance",{"title":693,"path":694,"stem":695,"access":12},"guards","\u002Fservices\u002Fguards","services\u002Fguards",{"title":697,"path":698,"stem":699,"access":12},"history","\u002Fservices\u002Fhistory","services\u002Fhistory",{"title":701,"path":702,"stem":703,"access":12},"i18n","\u002Fservices\u002Fi18n","services\u002Fi18n",{"title":705,"path":706,"stem":707,"children":708,"access":12},"indexing","\u002Fservices\u002Findexing","services\u002Findexing",[709],{"title":705,"path":706,"stem":707,"access":12},{"title":711,"path":712,"stem":713,"access":12},"introspection","\u002Fservices\u002Fintrospection","services\u002Fintrospection",{"title":715,"path":716,"stem":717,"access":12},"joins","\u002Fservices\u002Fjoins","services\u002Fjoins",{"title":719,"path":720,"stem":721,"access":12},"lazy","\u002Fservices\u002Flazy","services\u002Flazy",{"title":723,"path":724,"stem":725,"access":12},"links","\u002Fservices\u002Flinks","services\u002Flinks",{"title":727,"path":728,"stem":729,"access":12},"live","\u002Fservices\u002Flive","services\u002Flive",{"title":731,"path":732,"stem":733,"access":12},"lookup","\u002Fservices\u002Flookup","services\u002Flookup",{"title":735,"path":736,"stem":737,"access":12},"manifest","\u002Fservices\u002Fmanifest","services\u002Fmanifest",{"title":739,"path":740,"stem":741,"access":12},"materialized-views","\u002Fservices\u002Fmaterialized-views","services\u002Fmaterialized-views",{"title":743,"path":744,"stem":745,"access":12},"Metadata ladder","\u002Fservices\u002Fmetadata-ladder","services\u002Fmetadata-ladder",{"title":747,"path":748,"stem":749,"access":12},"Metadata riders","\u002Fservices\u002Fmetadata-riders","services\u002Fmetadata-riders",{"title":751,"path":752,"stem":753,"access":12,"badge":754},"metrics","\u002Fservices\u002Fmetrics","services\u002Fmetrics","Planned",{"title":756,"path":757,"stem":758,"access":12,"badge":754},"migrations","\u002Fservices\u002Fmigrations","services\u002Fmigrations",{"title":760,"path":761,"stem":762,"access":12},"money","\u002Fservices\u002Fmoney","services\u002Fmoney",{"title":764,"path":765,"stem":766,"access":12},"numbering","\u002Fservices\u002Fnumbering","services\u002Fnumbering",{"title":768,"path":769,"stem":770,"access":12},"overlay-views","\u002Fservices\u002Foverlay-views","services\u002Foverlay-views",{"title":772,"path":773,"stem":774,"access":12,"badge":754},"partitioning","\u002Fservices\u002Fpartitioning","services\u002Fpartitioning",{"title":776,"path":777,"stem":778,"access":12},"periods","\u002Fservices\u002Fperiods","services\u002Fperiods",{"title":780,"path":781,"stem":782,"access":12},"persisted-schemas","\u002Fservices\u002Fpersisted-schemas","services\u002Fpersisted-schemas",{"title":784,"path":785,"stem":786,"access":12},"plaintext-bypass","\u002Fservices\u002Fplaintext-bypass","services\u002Fplaintext-bypass",{"title":788,"path":789,"stem":790,"access":12},"pod-redirect","\u002Fservices\u002Fpod-redirect","services\u002Fpod-redirect",{"title":792,"path":793,"stem":794,"access":12},"pod-signature","\u002Fservices\u002Fpod-signature","services\u002Fpod-signature",{"title":796,"path":797,"stem":798,"access":12},"policy","\u002Fservices\u002Fpolicy","services\u002Fpolicy",{"title":800,"path":801,"stem":802,"access":12},"portability","\u002Fservices\u002Fportability","services\u002Fportability",{"title":804,"path":805,"stem":806,"access":12},"reduce","\u002Fservices\u002Freduce","services\u002Freduce",{"title":808,"path":809,"stem":810,"access":12},"routing","\u002Fservices\u002Frouting","services\u002Frouting",{"title":812,"path":813,"stem":814,"access":12},"satellites","\u002Fservices\u002Fsatellites","services\u002Fsatellites",{"title":816,"path":817,"stem":818,"access":12},"schema-identifiers","\u002Fservices\u002Fschema-identifiers","services\u002Fschema-identifiers",{"title":820,"path":821,"stem":822,"access":12},"schema-update","\u002Fservices\u002Fschema-update","services\u002Fschema-update",{"title":824,"path":825,"stem":826,"access":12},"sealed-record","\u002Fservices\u002Fsealed-record","services\u002Fsealed-record",{"title":828,"path":829,"stem":830,"access":12},"sealing provider id","\u002Fservices\u002Fsealing-pid-stability","services\u002Fsealing-pid-stability",{"title":832,"path":833,"stem":834,"access":12},"search — full-text","\u002Fservices\u002Fsearch","services\u002Fsearch",{"title":836,"path":837,"stem":838,"access":12},"sequence","\u002Fservices\u002Fsequence","services\u002Fsequence",{"title":840,"path":841,"stem":842,"access":12},"session","\u002Fservices\u002Fsession","services\u002Fsession",{"title":844,"path":845,"stem":846,"access":12},"session-tiers","\u002Fservices\u002Fsession-tiers","services\u002Fsession-tiers",{"title":848,"path":849,"stem":850,"access":12},"shadow","\u002Fservices\u002Fshadow","services\u002Fshadow",{"title":852,"path":853,"stem":854,"access":12},"share-link","\u002Fservices\u002Fshare-link","services\u002Fshare-link",{"title":856,"path":857,"stem":858,"access":12},"snapshots","\u002Fservices\u002Fsnapshots","services\u002Fsnapshots",{"title":860,"path":861,"stem":862,"access":12},"store capabilities","\u002Fservices\u002Fstorage-capability-matrix","services\u002Fstorage-capability-matrix",{"title":864,"path":865,"stem":866,"access":12},"sync","\u002Fservices\u002Fsync","services\u002Fsync",{"title":868,"path":869,"stem":870,"access":12},"team","\u002Fservices\u002Fteam","services\u002Fteam",{"title":872,"path":873,"stem":874,"access":12},"tiers","\u002Fservices\u002Ftiers","services\u002Ftiers",{"title":876,"path":877,"stem":878,"access":12},"transactions","\u002Fservices\u002Ftransactions","services\u002Ftransactions",{"title":880,"path":881,"stem":882,"access":12},"partitions","\u002Fservices\u002Ftransferable-partitions","services\u002Ftransferable-partitions",{"title":884,"path":885,"stem":886,"access":12},"user-envelope","\u002Fservices\u002Fuser-envelope","services\u002Fuser-envelope",{"title":888,"path":889,"stem":890,"access":12,"badge":754},"validation","\u002Fservices\u002Fvalidation","services\u002Fvalidation",{"title":892,"path":893,"stem":894,"access":12},"vault-head","\u002Fservices\u002Fvault-head","services\u002Fvault-head",{"title":896,"path":897,"stem":898,"access":12},"via","\u002Fservices\u002Fvia","services\u002Fvia",{"title":900,"path":901,"stem":902,"access":12},"withdrawal","\u002Fservices\u002Fwithdrawal","services\u002Fwithdrawal",{"title":904,"path":905,"stem":906,"children":907},"Start","\u002Fstart","start",[908,911,915,919,923],{"title":10,"path":905,"stem":909,"access":12,"icon":910},"start\u002Findex","i-lucide-flag",{"title":912,"path":913,"stem":914,"access":12},"Install","\u002Fstart\u002Finstall","start\u002F1.install",{"title":916,"path":917,"stem":918,"access":12},"Your first vault","\u002Fstart\u002Ffirst-vault","start\u002F2.first-vault",{"title":920,"path":921,"stem":922,"access":12},"Your first service","\u002Fstart\u002Ffirst-service","start\u002F3.first-service",{"title":924,"path":925,"stem":926,"access":12},"See the ciphertext","\u002Fstart\u002Fsee-the-ciphertext","start\u002F4.see-the-ciphertext",{"id":928,"title":715,"access":12,"apiToc":929,"body":930,"category":3634,"description":3635,"extension":3636,"meta":3637,"navigation":3634,"nest":3638,"path":716,"seo":3639,"sinceVersion":3634,"status":3640,"stem":717,"subtitle":3634,"tier":3641,"tocExternal":3634,"__hash__":3642},"docs\u002Fservices\u002Fjoins.md",false,{"type":931,"value":932,"toc":3618},"minimark",[933,936,940,945,984,995,1017,1021,1032,1461,1465,1470,1489,1754,1916,1953,1957,1967,2423,2429,2538,2542,2565,2607,2842,2853,2857,2875,3068,3092,3096,3102,3212,3240,3316,3404,3409,3413,3418,3468,3472,3546,3550,3614],[934,935,715],"h1",{"id":715},[937,938],"service-meta",{":rows":939},"[{\"label\":\"Subpath\",\"value\":\"*(currently always-core; a dedicated `@noy-db\u002Fhub\u002Fjoins` subpath is a planned follow-up)*\"},{\"label\":\"Factory\",\"value\":\"`withJoins()` *(planned)*\"},{\"label\":\"Cluster\",\"value\":\"A — Read & Query\"}]",[941,942,944],"h2",{"id":943},"what-it-does","What it does",[946,947,948,949,954,955,962,963,966,967,970,971,974,975,978,979,983],"p",{},"A ",[950,951,953],"a",{"href":952},"..\u002Fcore\u002F01-overview","collection"," can declare a foreign-key field with ",[950,956,958],{"href":957},".\u002Fforeign-refs",[959,960,961],"code",{},"ref()"," — for example an invoice's ",[959,964,965],{},"clientId"," pointing at the ",[959,968,969],{},"clients"," collection. ",[959,972,973],{},".join()"," is the query-builder method that resolves one of those declared references and attaches the target record onto the result under an alias you choose, so ",[959,976,977],{},"invoice.client.name"," is available without a second round trip. Joins run ",[980,981,982],"strong",{},"inside the hub, after decryption"," — the storage backend only ever sees ciphertext and never runs the query itself.",[946,985,986,987,990,991,994],{},"You want it for parent-record lookups that follow an existing reference: reports that need the client's name next to each invoice, multi-step navigation (invoice → client → region), or a UI pane that should re-render whenever either the invoice or its client changes. For pairing rows that have ",[980,988,989],{},"no"," declared reference (every worker × every pay period), use ",[950,992,657],{"href":993},".\u002Fcross-join"," instead.",[946,996,997,998,1001,1002,1005,1006,1009,1010,1012,1013,1016],{},"Joins are part of the core query builder today — there is no ",[959,999,1000],{},"with*()"," factory to opt into and no bundle cost to avoid. The catalog reserves a dedicated ",[959,1003,1004],{},"@noy-db\u002Fhub\u002Fjoins"," subpath and a ",[959,1007,1008],{},"withJoins()"," factory (~470 LOC) for a future extraction, but until that lands ",[959,1011,973],{}," is simply available on every ",[959,1014,1015],{},"collection.query()",".",[941,1018,1020],{"id":1019},"opt-in","Opt in",[946,1022,1023,1024,1026,1027,1031],{},"No opt-in is needed for ",[959,1025,973],{}," itself. Declare the reference when you create the collection, with ",[950,1028,1029],{"href":957},[959,1030,961],{},":",[1033,1034,1039],"pre",{"className":1035,"code":1036,"language":1037,"meta":1038,"style":1038},"language-ts shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import { createNoydb, ref } from '@noy-db\u002Fhub'\nimport { toMemory } from '@noy-db\u002Fto-memory'\n\ntype Client = { id: string; name: string; tier: 'standard' | 'premium' }\ntype Invoice = { id: string; amount: number; status: 'draft' | 'open' | 'paid'; clientId: string }\n\nconst db = await createNoydb({ store: toMemory(), user: 'alice', secret: 'a-strong-secret' })\nconst vault = await db.openVault('acme')\n\nconst clients = vault.collection\u003CClient>('clients')\nconst invoices = vault.collection\u003CInvoice>('invoices', {\n  refs: { clientId: ref('clients') },\n})\n","ts","",[959,1040,1041,1080,1101,1108,1171,1242,1247,1314,1345,1350,1386,1423,1453],{"__ignoreMap":1038},[1042,1043,1046,1050,1054,1058,1061,1064,1067,1070,1073,1077],"span",{"class":1044,"line":1045},"line",1,[1042,1047,1049],{"class":1048},"s7zQu","import",[1042,1051,1053],{"class":1052},"sMK4o"," {",[1042,1055,1057],{"class":1056},"sTEyZ"," createNoydb",[1042,1059,1060],{"class":1052},",",[1042,1062,1063],{"class":1056}," ref",[1042,1065,1066],{"class":1052}," }",[1042,1068,1069],{"class":1048}," from",[1042,1071,1072],{"class":1052}," '",[1042,1074,1076],{"class":1075},"sfazB","@noy-db\u002Fhub",[1042,1078,1079],{"class":1052},"'\n",[1042,1081,1083,1085,1087,1090,1092,1094,1096,1099],{"class":1044,"line":1082},2,[1042,1084,1049],{"class":1048},[1042,1086,1053],{"class":1052},[1042,1088,1089],{"class":1056}," toMemory",[1042,1091,1066],{"class":1052},[1042,1093,1069],{"class":1048},[1042,1095,1072],{"class":1052},[1042,1097,1098],{"class":1075},"@noy-db\u002Fto-memory",[1042,1100,1079],{"class":1052},[1042,1102,1104],{"class":1044,"line":1103},3,[1042,1105,1107],{"emptyLinePlaceholder":1106},true,"\n",[1042,1109,1111,1115,1119,1122,1124,1128,1130,1133,1136,1139,1141,1143,1145,1148,1150,1152,1155,1158,1161,1163,1166,1168],{"class":1044,"line":1110},4,[1042,1112,1114],{"class":1113},"spNyl","type",[1042,1116,1118],{"class":1117},"sBMFI"," Client",[1042,1120,1121],{"class":1052}," =",[1042,1123,1053],{"class":1052},[1042,1125,1127],{"class":1126},"swJcz"," id",[1042,1129,1031],{"class":1052},[1042,1131,1132],{"class":1117}," string",[1042,1134,1135],{"class":1052},";",[1042,1137,1138],{"class":1126}," name",[1042,1140,1031],{"class":1052},[1042,1142,1132],{"class":1117},[1042,1144,1135],{"class":1052},[1042,1146,1147],{"class":1126}," tier",[1042,1149,1031],{"class":1052},[1042,1151,1072],{"class":1052},[1042,1153,1154],{"class":1075},"standard",[1042,1156,1157],{"class":1052},"'",[1042,1159,1160],{"class":1052}," |",[1042,1162,1072],{"class":1052},[1042,1164,1165],{"class":1075},"premium",[1042,1167,1157],{"class":1052},[1042,1169,1170],{"class":1052}," }\n",[1042,1172,1174,1176,1179,1181,1183,1185,1187,1189,1191,1194,1196,1199,1201,1204,1206,1208,1211,1213,1215,1217,1220,1222,1224,1226,1229,1231,1233,1236,1238,1240],{"class":1044,"line":1173},5,[1042,1175,1114],{"class":1113},[1042,1177,1178],{"class":1117}," Invoice",[1042,1180,1121],{"class":1052},[1042,1182,1053],{"class":1052},[1042,1184,1127],{"class":1126},[1042,1186,1031],{"class":1052},[1042,1188,1132],{"class":1117},[1042,1190,1135],{"class":1052},[1042,1192,1193],{"class":1126}," amount",[1042,1195,1031],{"class":1052},[1042,1197,1198],{"class":1117}," number",[1042,1200,1135],{"class":1052},[1042,1202,1203],{"class":1126}," status",[1042,1205,1031],{"class":1052},[1042,1207,1072],{"class":1052},[1042,1209,1210],{"class":1075},"draft",[1042,1212,1157],{"class":1052},[1042,1214,1160],{"class":1052},[1042,1216,1072],{"class":1052},[1042,1218,1219],{"class":1075},"open",[1042,1221,1157],{"class":1052},[1042,1223,1160],{"class":1052},[1042,1225,1072],{"class":1052},[1042,1227,1228],{"class":1075},"paid",[1042,1230,1157],{"class":1052},[1042,1232,1135],{"class":1052},[1042,1234,1235],{"class":1126}," clientId",[1042,1237,1031],{"class":1052},[1042,1239,1132],{"class":1117},[1042,1241,1170],{"class":1052},[1042,1243,1245],{"class":1044,"line":1244},6,[1042,1246,1107],{"emptyLinePlaceholder":1106},[1042,1248,1250,1253,1256,1259,1262,1265,1268,1271,1274,1276,1278,1281,1283,1286,1288,1290,1293,1295,1297,1300,1302,1304,1307,1309,1311],{"class":1044,"line":1249},7,[1042,1251,1252],{"class":1113},"const",[1042,1254,1255],{"class":1056}," db ",[1042,1257,1258],{"class":1052},"=",[1042,1260,1261],{"class":1048}," await",[1042,1263,1057],{"class":1264},"s2Zo4",[1042,1266,1267],{"class":1056},"(",[1042,1269,1270],{"class":1052},"{",[1042,1272,1273],{"class":1126}," store",[1042,1275,1031],{"class":1052},[1042,1277,1089],{"class":1264},[1042,1279,1280],{"class":1056},"()",[1042,1282,1060],{"class":1052},[1042,1284,1285],{"class":1126}," user",[1042,1287,1031],{"class":1052},[1042,1289,1072],{"class":1052},[1042,1291,1292],{"class":1075},"alice",[1042,1294,1157],{"class":1052},[1042,1296,1060],{"class":1052},[1042,1298,1299],{"class":1126}," secret",[1042,1301,1031],{"class":1052},[1042,1303,1072],{"class":1052},[1042,1305,1306],{"class":1075},"a-strong-secret",[1042,1308,1157],{"class":1052},[1042,1310,1066],{"class":1052},[1042,1312,1313],{"class":1056},")\n",[1042,1315,1317,1319,1322,1324,1326,1329,1331,1334,1336,1338,1341,1343],{"class":1044,"line":1316},8,[1042,1318,1252],{"class":1113},[1042,1320,1321],{"class":1056}," vault ",[1042,1323,1258],{"class":1052},[1042,1325,1261],{"class":1048},[1042,1327,1328],{"class":1056}," db",[1042,1330,1016],{"class":1052},[1042,1332,1333],{"class":1264},"openVault",[1042,1335,1267],{"class":1056},[1042,1337,1157],{"class":1052},[1042,1339,1340],{"class":1075},"acme",[1042,1342,1157],{"class":1052},[1042,1344,1313],{"class":1056},[1042,1346,1348],{"class":1044,"line":1347},9,[1042,1349,1107],{"emptyLinePlaceholder":1106},[1042,1351,1353,1355,1358,1360,1363,1365,1367,1370,1373,1376,1378,1380,1382,1384],{"class":1044,"line":1352},10,[1042,1354,1252],{"class":1113},[1042,1356,1357],{"class":1056}," clients ",[1042,1359,1258],{"class":1052},[1042,1361,1362],{"class":1056}," vault",[1042,1364,1016],{"class":1052},[1042,1366,953],{"class":1264},[1042,1368,1369],{"class":1052},"\u003C",[1042,1371,1372],{"class":1117},"Client",[1042,1374,1375],{"class":1052},">",[1042,1377,1267],{"class":1056},[1042,1379,1157],{"class":1052},[1042,1381,969],{"class":1075},[1042,1383,1157],{"class":1052},[1042,1385,1313],{"class":1056},[1042,1387,1389,1391,1394,1396,1398,1400,1402,1404,1407,1409,1411,1413,1416,1418,1420],{"class":1044,"line":1388},11,[1042,1390,1252],{"class":1113},[1042,1392,1393],{"class":1056}," invoices ",[1042,1395,1258],{"class":1052},[1042,1397,1362],{"class":1056},[1042,1399,1016],{"class":1052},[1042,1401,953],{"class":1264},[1042,1403,1369],{"class":1052},[1042,1405,1406],{"class":1117},"Invoice",[1042,1408,1375],{"class":1052},[1042,1410,1267],{"class":1056},[1042,1412,1157],{"class":1052},[1042,1414,1415],{"class":1075},"invoices",[1042,1417,1157],{"class":1052},[1042,1419,1060],{"class":1052},[1042,1421,1422],{"class":1052}," {\n",[1042,1424,1426,1429,1431,1433,1435,1437,1439,1441,1443,1445,1447,1450],{"class":1044,"line":1425},12,[1042,1427,1428],{"class":1126},"  refs",[1042,1430,1031],{"class":1052},[1042,1432,1053],{"class":1052},[1042,1434,1235],{"class":1126},[1042,1436,1031],{"class":1052},[1042,1438,1063],{"class":1264},[1042,1440,1267],{"class":1056},[1042,1442,1157],{"class":1052},[1042,1444,969],{"class":1075},[1042,1446,1157],{"class":1052},[1042,1448,1449],{"class":1056},") ",[1042,1451,1452],{"class":1052},"},\n",[1042,1454,1456,1459],{"class":1044,"line":1455},13,[1042,1457,1458],{"class":1052},"}",[1042,1460,1313],{"class":1056},[941,1462,1464],{"id":1463},"usage","Usage",[1466,1467,1469],"h3",{"id":1468},"single-fk-join","Single-FK join",[946,1471,1472,1475,1476,1479,1480,1483,1484,1488],{},[959,1473,1474],{},"query.join(field, { as })"," resolves the declared reference and attaches the target record under ",[959,1477,1478],{},"as",". ",[959,1481,1482],{},"toArray()"," is synchronous — it reads the already-decrypted in-memory cache, same as the rest of the ",[950,1485,1487],{"href":1486},"..\u002Fcore\u002Fcollection\u002Fquerying","query basics"," terminals:",[1033,1490,1492],{"className":1035,"code":1491,"language":1037,"meta":1038,"style":1038},"await clients.put('cli-A', { id: 'cli-A', name: 'Acme Corp', tier: 'premium' })\nawait invoices.put('inv-1', { id: 'inv-1', amount: 1200, status: 'paid', clientId: 'cli-A' })\n\nconst enriched = invoices.query()\n  .where('status', '==', 'paid')\n  .join\u003C'client', Client>('clientId', { as: 'client' })\n  .toArray()\n\u002F\u002F → 1 row, shaped like:\n",[959,1493,1494,1559,1631,1635,1654,1690,1739,1748],{"__ignoreMap":1038},[1042,1495,1496,1499,1502,1504,1507,1509,1511,1514,1516,1518,1520,1522,1524,1526,1528,1530,1532,1534,1536,1538,1541,1543,1545,1547,1549,1551,1553,1555,1557],{"class":1044,"line":1045},[1042,1497,1498],{"class":1048},"await",[1042,1500,1501],{"class":1056}," clients",[1042,1503,1016],{"class":1052},[1042,1505,1506],{"class":1264},"put",[1042,1508,1267],{"class":1056},[1042,1510,1157],{"class":1052},[1042,1512,1513],{"class":1075},"cli-A",[1042,1515,1157],{"class":1052},[1042,1517,1060],{"class":1052},[1042,1519,1053],{"class":1052},[1042,1521,1127],{"class":1126},[1042,1523,1031],{"class":1052},[1042,1525,1072],{"class":1052},[1042,1527,1513],{"class":1075},[1042,1529,1157],{"class":1052},[1042,1531,1060],{"class":1052},[1042,1533,1138],{"class":1126},[1042,1535,1031],{"class":1052},[1042,1537,1072],{"class":1052},[1042,1539,1540],{"class":1075},"Acme Corp",[1042,1542,1157],{"class":1052},[1042,1544,1060],{"class":1052},[1042,1546,1147],{"class":1126},[1042,1548,1031],{"class":1052},[1042,1550,1072],{"class":1052},[1042,1552,1165],{"class":1075},[1042,1554,1157],{"class":1052},[1042,1556,1066],{"class":1052},[1042,1558,1313],{"class":1056},[1042,1560,1561,1563,1566,1568,1570,1572,1574,1577,1579,1581,1583,1585,1587,1589,1591,1593,1595,1597,1599,1603,1605,1607,1609,1611,1613,1615,1617,1619,1621,1623,1625,1627,1629],{"class":1044,"line":1082},[1042,1562,1498],{"class":1048},[1042,1564,1565],{"class":1056}," invoices",[1042,1567,1016],{"class":1052},[1042,1569,1506],{"class":1264},[1042,1571,1267],{"class":1056},[1042,1573,1157],{"class":1052},[1042,1575,1576],{"class":1075},"inv-1",[1042,1578,1157],{"class":1052},[1042,1580,1060],{"class":1052},[1042,1582,1053],{"class":1052},[1042,1584,1127],{"class":1126},[1042,1586,1031],{"class":1052},[1042,1588,1072],{"class":1052},[1042,1590,1576],{"class":1075},[1042,1592,1157],{"class":1052},[1042,1594,1060],{"class":1052},[1042,1596,1193],{"class":1126},[1042,1598,1031],{"class":1052},[1042,1600,1602],{"class":1601},"sbssI"," 1200",[1042,1604,1060],{"class":1052},[1042,1606,1203],{"class":1126},[1042,1608,1031],{"class":1052},[1042,1610,1072],{"class":1052},[1042,1612,1228],{"class":1075},[1042,1614,1157],{"class":1052},[1042,1616,1060],{"class":1052},[1042,1618,1235],{"class":1126},[1042,1620,1031],{"class":1052},[1042,1622,1072],{"class":1052},[1042,1624,1513],{"class":1075},[1042,1626,1157],{"class":1052},[1042,1628,1066],{"class":1052},[1042,1630,1313],{"class":1056},[1042,1632,1633],{"class":1044,"line":1103},[1042,1634,1107],{"emptyLinePlaceholder":1106},[1042,1636,1637,1639,1642,1644,1646,1648,1651],{"class":1044,"line":1110},[1042,1638,1252],{"class":1113},[1042,1640,1641],{"class":1056}," enriched ",[1042,1643,1258],{"class":1052},[1042,1645,1565],{"class":1056},[1042,1647,1016],{"class":1052},[1042,1649,1650],{"class":1264},"query",[1042,1652,1653],{"class":1056},"()\n",[1042,1655,1656,1659,1662,1664,1666,1669,1671,1673,1675,1678,1680,1682,1684,1686,1688],{"class":1044,"line":1173},[1042,1657,1658],{"class":1052},"  .",[1042,1660,1661],{"class":1264},"where",[1042,1663,1267],{"class":1056},[1042,1665,1157],{"class":1052},[1042,1667,1668],{"class":1075},"status",[1042,1670,1157],{"class":1052},[1042,1672,1060],{"class":1052},[1042,1674,1072],{"class":1052},[1042,1676,1677],{"class":1075},"==",[1042,1679,1157],{"class":1052},[1042,1681,1060],{"class":1052},[1042,1683,1072],{"class":1052},[1042,1685,1228],{"class":1075},[1042,1687,1157],{"class":1052},[1042,1689,1313],{"class":1056},[1042,1691,1692,1694,1697,1699,1701,1704,1706,1708,1710,1712,1714,1716,1718,1720,1722,1724,1727,1729,1731,1733,1735,1737],{"class":1044,"line":1244},[1042,1693,1658],{"class":1052},[1042,1695,1696],{"class":1264},"join",[1042,1698,1369],{"class":1052},[1042,1700,1157],{"class":1052},[1042,1702,1703],{"class":1075},"client",[1042,1705,1157],{"class":1052},[1042,1707,1060],{"class":1052},[1042,1709,1118],{"class":1117},[1042,1711,1375],{"class":1052},[1042,1713,1267],{"class":1056},[1042,1715,1157],{"class":1052},[1042,1717,965],{"class":1075},[1042,1719,1157],{"class":1052},[1042,1721,1060],{"class":1052},[1042,1723,1053],{"class":1052},[1042,1725,1726],{"class":1126}," as",[1042,1728,1031],{"class":1052},[1042,1730,1072],{"class":1052},[1042,1732,1703],{"class":1075},[1042,1734,1157],{"class":1052},[1042,1736,1066],{"class":1052},[1042,1738,1313],{"class":1056},[1042,1740,1741,1743,1746],{"class":1044,"line":1249},[1042,1742,1658],{"class":1052},[1042,1744,1745],{"class":1264},"toArray",[1042,1747,1653],{"class":1056},[1042,1749,1750],{"class":1044,"line":1316},[1042,1751,1753],{"class":1752},"sHwdD","\u002F\u002F → 1 row, shaped like:\n",[1033,1755,1758],{"className":1756,"code":1757,"language":141,"meta":1038,"style":1038},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","[\n  {\n    \"id\": \"inv-1\",\n    \"amount\": 1200,\n    \"status\": \"paid\",\n    \"clientId\": \"cli-A\",\n    \"client\": { \"id\": \"cli-A\", \"name\": \"Acme Corp\", \"tier\": \"premium\" }\n  }\n]\n",[959,1759,1760,1765,1770,1793,1808,1826,1844,1906,1911],{"__ignoreMap":1038},[1042,1761,1762],{"class":1044,"line":1045},[1042,1763,1764],{"class":1052},"[\n",[1042,1766,1767],{"class":1044,"line":1082},[1042,1768,1769],{"class":1052},"  {\n",[1042,1771,1772,1775,1778,1781,1783,1786,1788,1790],{"class":1044,"line":1103},[1042,1773,1774],{"class":1052},"    \"",[1042,1776,1777],{"class":1113},"id",[1042,1779,1780],{"class":1052},"\"",[1042,1782,1031],{"class":1052},[1042,1784,1785],{"class":1052}," \"",[1042,1787,1576],{"class":1075},[1042,1789,1780],{"class":1052},[1042,1791,1792],{"class":1052},",\n",[1042,1794,1795,1797,1800,1802,1804,1806],{"class":1044,"line":1110},[1042,1796,1774],{"class":1052},[1042,1798,1799],{"class":1113},"amount",[1042,1801,1780],{"class":1052},[1042,1803,1031],{"class":1052},[1042,1805,1602],{"class":1601},[1042,1807,1792],{"class":1052},[1042,1809,1810,1812,1814,1816,1818,1820,1822,1824],{"class":1044,"line":1173},[1042,1811,1774],{"class":1052},[1042,1813,1668],{"class":1113},[1042,1815,1780],{"class":1052},[1042,1817,1031],{"class":1052},[1042,1819,1785],{"class":1052},[1042,1821,1228],{"class":1075},[1042,1823,1780],{"class":1052},[1042,1825,1792],{"class":1052},[1042,1827,1828,1830,1832,1834,1836,1838,1840,1842],{"class":1044,"line":1244},[1042,1829,1774],{"class":1052},[1042,1831,965],{"class":1113},[1042,1833,1780],{"class":1052},[1042,1835,1031],{"class":1052},[1042,1837,1785],{"class":1052},[1042,1839,1513],{"class":1075},[1042,1841,1780],{"class":1052},[1042,1843,1792],{"class":1052},[1042,1845,1846,1848,1850,1852,1854,1856,1858,1860,1862,1864,1866,1868,1870,1872,1874,1877,1879,1881,1883,1885,1887,1889,1891,1894,1896,1898,1900,1902,1904],{"class":1044,"line":1249},[1042,1847,1774],{"class":1052},[1042,1849,1703],{"class":1113},[1042,1851,1780],{"class":1052},[1042,1853,1031],{"class":1052},[1042,1855,1053],{"class":1052},[1042,1857,1785],{"class":1052},[1042,1859,1777],{"class":1117},[1042,1861,1780],{"class":1052},[1042,1863,1031],{"class":1052},[1042,1865,1785],{"class":1052},[1042,1867,1513],{"class":1075},[1042,1869,1780],{"class":1052},[1042,1871,1060],{"class":1052},[1042,1873,1785],{"class":1052},[1042,1875,1876],{"class":1117},"name",[1042,1878,1780],{"class":1052},[1042,1880,1031],{"class":1052},[1042,1882,1785],{"class":1052},[1042,1884,1540],{"class":1075},[1042,1886,1780],{"class":1052},[1042,1888,1060],{"class":1052},[1042,1890,1785],{"class":1052},[1042,1892,1893],{"class":1117},"tier",[1042,1895,1780],{"class":1052},[1042,1897,1031],{"class":1052},[1042,1899,1785],{"class":1052},[1042,1901,1165],{"class":1075},[1042,1903,1780],{"class":1052},[1042,1905,1170],{"class":1052},[1042,1907,1908],{"class":1044,"line":1316},[1042,1909,1910],{"class":1052},"  }\n",[1042,1912,1913],{"class":1044,"line":1347},[1042,1914,1915],{"class":1052},"]\n",[946,1917,1918,1919,1922,1923,1925,1926,1479,1929,1931,1932,1934,1935,1938,1939,1942,1943,1945,1946,1949,1950,1016],{},"The ",[959,1920,1921],{},"Right"," type parameter (",[959,1924,1372],{}," above) is optional — omit it and the joined field types as ",[959,1927,1928],{},"unknown",[959,1930,973],{}," requires a query built via ",[959,1933,1015],{},"; the join planner picks a ",[980,1936,1937],{},"nested-loop"," strategy when the target source supports ",[959,1940,1941],{},"lookupById"," (the normal case for a ",[959,1944,103],{}," target) or a ",[980,1947,1948],{},"hash"," strategy otherwise, auto-selected unless you force one with ",[959,1951,1952],{},"{ strategy: 'hash' }",[1466,1954,1956],{"id":1955},"multi-fk-chaining","Multi-FK chaining",[946,1958,1959,1960,1962,1963,1966],{},"Chain ",[959,1961,973],{}," calls to resolve more than one reference on the same left record — each call adds its own alias. A collection's ",[959,1964,1965],{},"refs"," are fixed at the point you first open it, so declare every FK you plan to join up front:",[1033,1968,1970],{"className":1035,"code":1969,"language":1037,"meta":1038,"style":1038},"type Category = { id: string; label: string }\ntype FullInvoice = Invoice & { categoryId: string }\n\nconst categories = vault.collection\u003CCategory>('categories')\nconst fullInvoices = vault.collection\u003CFullInvoice>('full-invoices', {\n  refs: { clientId: ref('clients'), categoryId: ref('categories') },\n})\n\nawait categories.put('cat-1', { id: 'cat-1', label: 'Consulting' })\nawait fullInvoices.put('inv-2', { id: 'inv-2', amount: 800, status: 'open', clientId: 'cli-A', categoryId: 'cat-1' })\n\nconst rows = fullInvoices.query()\n  .join\u003C'client', Client>('clientId', { as: 'client' })\n  .join\u003C'category', Category>('categoryId', { as: 'category' })\n  .toArray()\n\u002F\u002F → [{ ..., client: { id: 'cli-A', name: 'Acme Corp', tier: 'premium' },\n\u002F\u002F      category: { id: 'cat-1', label: 'Consulting' } }]\n",[959,1971,1972,2000,2025,2029,2062,2097,2142,2148,2152,2203,2286,2290,2307,2353,2402,2411,2417],{"__ignoreMap":1038},[1042,1973,1974,1976,1979,1981,1983,1985,1987,1989,1991,1994,1996,1998],{"class":1044,"line":1045},[1042,1975,1114],{"class":1113},[1042,1977,1978],{"class":1117}," Category",[1042,1980,1121],{"class":1052},[1042,1982,1053],{"class":1052},[1042,1984,1127],{"class":1126},[1042,1986,1031],{"class":1052},[1042,1988,1132],{"class":1117},[1042,1990,1135],{"class":1052},[1042,1992,1993],{"class":1126}," label",[1042,1995,1031],{"class":1052},[1042,1997,1132],{"class":1117},[1042,1999,1170],{"class":1052},[1042,2001,2002,2004,2007,2009,2011,2014,2016,2019,2021,2023],{"class":1044,"line":1082},[1042,2003,1114],{"class":1113},[1042,2005,2006],{"class":1117}," FullInvoice",[1042,2008,1121],{"class":1052},[1042,2010,1178],{"class":1117},[1042,2012,2013],{"class":1052}," &",[1042,2015,1053],{"class":1052},[1042,2017,2018],{"class":1126}," categoryId",[1042,2020,1031],{"class":1052},[1042,2022,1132],{"class":1117},[1042,2024,1170],{"class":1052},[1042,2026,2027],{"class":1044,"line":1103},[1042,2028,1107],{"emptyLinePlaceholder":1106},[1042,2030,2031,2033,2036,2038,2040,2042,2044,2046,2049,2051,2053,2055,2058,2060],{"class":1044,"line":1110},[1042,2032,1252],{"class":1113},[1042,2034,2035],{"class":1056}," categories ",[1042,2037,1258],{"class":1052},[1042,2039,1362],{"class":1056},[1042,2041,1016],{"class":1052},[1042,2043,953],{"class":1264},[1042,2045,1369],{"class":1052},[1042,2047,2048],{"class":1117},"Category",[1042,2050,1375],{"class":1052},[1042,2052,1267],{"class":1056},[1042,2054,1157],{"class":1052},[1042,2056,2057],{"class":1075},"categories",[1042,2059,1157],{"class":1052},[1042,2061,1313],{"class":1056},[1042,2063,2064,2066,2069,2071,2073,2075,2077,2079,2082,2084,2086,2088,2091,2093,2095],{"class":1044,"line":1173},[1042,2065,1252],{"class":1113},[1042,2067,2068],{"class":1056}," fullInvoices ",[1042,2070,1258],{"class":1052},[1042,2072,1362],{"class":1056},[1042,2074,1016],{"class":1052},[1042,2076,953],{"class":1264},[1042,2078,1369],{"class":1052},[1042,2080,2081],{"class":1117},"FullInvoice",[1042,2083,1375],{"class":1052},[1042,2085,1267],{"class":1056},[1042,2087,1157],{"class":1052},[1042,2089,2090],{"class":1075},"full-invoices",[1042,2092,1157],{"class":1052},[1042,2094,1060],{"class":1052},[1042,2096,1422],{"class":1052},[1042,2098,2099,2101,2103,2105,2107,2109,2111,2113,2115,2117,2119,2122,2124,2126,2128,2130,2132,2134,2136,2138,2140],{"class":1044,"line":1244},[1042,2100,1428],{"class":1126},[1042,2102,1031],{"class":1052},[1042,2104,1053],{"class":1052},[1042,2106,1235],{"class":1126},[1042,2108,1031],{"class":1052},[1042,2110,1063],{"class":1264},[1042,2112,1267],{"class":1056},[1042,2114,1157],{"class":1052},[1042,2116,969],{"class":1075},[1042,2118,1157],{"class":1052},[1042,2120,2121],{"class":1056},")",[1042,2123,1060],{"class":1052},[1042,2125,2018],{"class":1126},[1042,2127,1031],{"class":1052},[1042,2129,1063],{"class":1264},[1042,2131,1267],{"class":1056},[1042,2133,1157],{"class":1052},[1042,2135,2057],{"class":1075},[1042,2137,1157],{"class":1052},[1042,2139,1449],{"class":1056},[1042,2141,1452],{"class":1052},[1042,2143,2144,2146],{"class":1044,"line":1249},[1042,2145,1458],{"class":1052},[1042,2147,1313],{"class":1056},[1042,2149,2150],{"class":1044,"line":1316},[1042,2151,1107],{"emptyLinePlaceholder":1106},[1042,2153,2154,2156,2159,2161,2163,2165,2167,2170,2172,2174,2176,2178,2180,2182,2184,2186,2188,2190,2192,2194,2197,2199,2201],{"class":1044,"line":1347},[1042,2155,1498],{"class":1048},[1042,2157,2158],{"class":1056}," categories",[1042,2160,1016],{"class":1052},[1042,2162,1506],{"class":1264},[1042,2164,1267],{"class":1056},[1042,2166,1157],{"class":1052},[1042,2168,2169],{"class":1075},"cat-1",[1042,2171,1157],{"class":1052},[1042,2173,1060],{"class":1052},[1042,2175,1053],{"class":1052},[1042,2177,1127],{"class":1126},[1042,2179,1031],{"class":1052},[1042,2181,1072],{"class":1052},[1042,2183,2169],{"class":1075},[1042,2185,1157],{"class":1052},[1042,2187,1060],{"class":1052},[1042,2189,1993],{"class":1126},[1042,2191,1031],{"class":1052},[1042,2193,1072],{"class":1052},[1042,2195,2196],{"class":1075},"Consulting",[1042,2198,1157],{"class":1052},[1042,2200,1066],{"class":1052},[1042,2202,1313],{"class":1056},[1042,2204,2205,2207,2210,2212,2214,2216,2218,2221,2223,2225,2227,2229,2231,2233,2235,2237,2239,2241,2243,2246,2248,2250,2252,2254,2256,2258,2260,2262,2264,2266,2268,2270,2272,2274,2276,2278,2280,2282,2284],{"class":1044,"line":1352},[1042,2206,1498],{"class":1048},[1042,2208,2209],{"class":1056}," fullInvoices",[1042,2211,1016],{"class":1052},[1042,2213,1506],{"class":1264},[1042,2215,1267],{"class":1056},[1042,2217,1157],{"class":1052},[1042,2219,2220],{"class":1075},"inv-2",[1042,2222,1157],{"class":1052},[1042,2224,1060],{"class":1052},[1042,2226,1053],{"class":1052},[1042,2228,1127],{"class":1126},[1042,2230,1031],{"class":1052},[1042,2232,1072],{"class":1052},[1042,2234,2220],{"class":1075},[1042,2236,1157],{"class":1052},[1042,2238,1060],{"class":1052},[1042,2240,1193],{"class":1126},[1042,2242,1031],{"class":1052},[1042,2244,2245],{"class":1601}," 800",[1042,2247,1060],{"class":1052},[1042,2249,1203],{"class":1126},[1042,2251,1031],{"class":1052},[1042,2253,1072],{"class":1052},[1042,2255,1219],{"class":1075},[1042,2257,1157],{"class":1052},[1042,2259,1060],{"class":1052},[1042,2261,1235],{"class":1126},[1042,2263,1031],{"class":1052},[1042,2265,1072],{"class":1052},[1042,2267,1513],{"class":1075},[1042,2269,1157],{"class":1052},[1042,2271,1060],{"class":1052},[1042,2273,2018],{"class":1126},[1042,2275,1031],{"class":1052},[1042,2277,1072],{"class":1052},[1042,2279,2169],{"class":1075},[1042,2281,1157],{"class":1052},[1042,2283,1066],{"class":1052},[1042,2285,1313],{"class":1056},[1042,2287,2288],{"class":1044,"line":1388},[1042,2289,1107],{"emptyLinePlaceholder":1106},[1042,2291,2292,2294,2297,2299,2301,2303,2305],{"class":1044,"line":1425},[1042,2293,1252],{"class":1113},[1042,2295,2296],{"class":1056}," rows ",[1042,2298,1258],{"class":1052},[1042,2300,2209],{"class":1056},[1042,2302,1016],{"class":1052},[1042,2304,1650],{"class":1264},[1042,2306,1653],{"class":1056},[1042,2308,2309,2311,2313,2315,2317,2319,2321,2323,2325,2327,2329,2331,2333,2335,2337,2339,2341,2343,2345,2347,2349,2351],{"class":1044,"line":1455},[1042,2310,1658],{"class":1052},[1042,2312,1696],{"class":1264},[1042,2314,1369],{"class":1052},[1042,2316,1157],{"class":1052},[1042,2318,1703],{"class":1075},[1042,2320,1157],{"class":1052},[1042,2322,1060],{"class":1052},[1042,2324,1118],{"class":1117},[1042,2326,1375],{"class":1052},[1042,2328,1267],{"class":1056},[1042,2330,1157],{"class":1052},[1042,2332,965],{"class":1075},[1042,2334,1157],{"class":1052},[1042,2336,1060],{"class":1052},[1042,2338,1053],{"class":1052},[1042,2340,1726],{"class":1126},[1042,2342,1031],{"class":1052},[1042,2344,1072],{"class":1052},[1042,2346,1703],{"class":1075},[1042,2348,1157],{"class":1052},[1042,2350,1066],{"class":1052},[1042,2352,1313],{"class":1056},[1042,2354,2356,2358,2360,2362,2364,2367,2369,2371,2373,2375,2377,2379,2382,2384,2386,2388,2390,2392,2394,2396,2398,2400],{"class":1044,"line":2355},14,[1042,2357,1658],{"class":1052},[1042,2359,1696],{"class":1264},[1042,2361,1369],{"class":1052},[1042,2363,1157],{"class":1052},[1042,2365,2366],{"class":1075},"category",[1042,2368,1157],{"class":1052},[1042,2370,1060],{"class":1052},[1042,2372,1978],{"class":1117},[1042,2374,1375],{"class":1052},[1042,2376,1267],{"class":1056},[1042,2378,1157],{"class":1052},[1042,2380,2381],{"class":1075},"categoryId",[1042,2383,1157],{"class":1052},[1042,2385,1060],{"class":1052},[1042,2387,1053],{"class":1052},[1042,2389,1726],{"class":1126},[1042,2391,1031],{"class":1052},[1042,2393,1072],{"class":1052},[1042,2395,2366],{"class":1075},[1042,2397,1157],{"class":1052},[1042,2399,1066],{"class":1052},[1042,2401,1313],{"class":1056},[1042,2403,2405,2407,2409],{"class":1044,"line":2404},15,[1042,2406,1658],{"class":1052},[1042,2408,1745],{"class":1264},[1042,2410,1653],{"class":1056},[1042,2412,2414],{"class":1044,"line":2413},16,[1042,2415,2416],{"class":1752},"\u002F\u002F → [{ ..., client: { id: 'cli-A', name: 'Acme Corp', tier: 'premium' },\n",[1042,2418,2420],{"class":1044,"line":2419},17,[1042,2421,2422],{"class":1752},"\u002F\u002F      category: { id: 'cat-1', label: 'Consulting' } }]\n",[946,2424,2425,2426,1031],{},"Post-join filtering on either alias's fields uses the general-purpose ",[959,2427,2428],{},".filter()",[1033,2430,2432],{"className":1035,"code":2431,"language":1037,"meta":1038,"style":1038},"invoices.query()\n  .join\u003C'client', Client>('clientId', { as: 'client' })\n  .filter(row => row.client?.tier === 'premium')\n  .toArray()\n",[959,2433,2434,2444,2490,2530],{"__ignoreMap":1038},[1042,2435,2436,2438,2440,2442],{"class":1044,"line":1045},[1042,2437,1415],{"class":1056},[1042,2439,1016],{"class":1052},[1042,2441,1650],{"class":1264},[1042,2443,1653],{"class":1056},[1042,2445,2446,2448,2450,2452,2454,2456,2458,2460,2462,2464,2466,2468,2470,2472,2474,2476,2478,2480,2482,2484,2486,2488],{"class":1044,"line":1082},[1042,2447,1658],{"class":1052},[1042,2449,1696],{"class":1264},[1042,2451,1369],{"class":1052},[1042,2453,1157],{"class":1052},[1042,2455,1703],{"class":1075},[1042,2457,1157],{"class":1052},[1042,2459,1060],{"class":1052},[1042,2461,1118],{"class":1117},[1042,2463,1375],{"class":1052},[1042,2465,1267],{"class":1056},[1042,2467,1157],{"class":1052},[1042,2469,965],{"class":1075},[1042,2471,1157],{"class":1052},[1042,2473,1060],{"class":1052},[1042,2475,1053],{"class":1052},[1042,2477,1726],{"class":1126},[1042,2479,1031],{"class":1052},[1042,2481,1072],{"class":1052},[1042,2483,1703],{"class":1075},[1042,2485,1157],{"class":1052},[1042,2487,1066],{"class":1052},[1042,2489,1313],{"class":1056},[1042,2491,2492,2494,2497,2499,2503,2506,2509,2511,2513,2516,2519,2522,2524,2526,2528],{"class":1044,"line":1103},[1042,2493,1658],{"class":1052},[1042,2495,2496],{"class":1264},"filter",[1042,2498,1267],{"class":1056},[1042,2500,2502],{"class":2501},"sHdIc","row",[1042,2504,2505],{"class":1113}," =>",[1042,2507,2508],{"class":1056}," row",[1042,2510,1016],{"class":1052},[1042,2512,1703],{"class":1056},[1042,2514,2515],{"class":1052},"?.",[1042,2517,2518],{"class":1056},"tier ",[1042,2520,2521],{"class":1052},"===",[1042,2523,1072],{"class":1052},[1042,2525,1165],{"class":1075},[1042,2527,1157],{"class":1052},[1042,2529,1313],{"class":1056},[1042,2531,2532,2534,2536],{"class":1044,"line":1110},[1042,2533,1658],{"class":1052},[1042,2535,1745],{"class":1264},[1042,2537,1653],{"class":1056},[1466,2539,2541],{"id":2540},"dangling-references","Dangling references",[946,2543,2544,2546,2547,2550,2551,2554,2555,2558,2559,1479,2562,2564],{},[959,2545,961],{}," declares one of three enforcement modes — ",[959,2548,2549],{},"strict"," (default), ",[959,2552,2553],{},"warn",", ",[959,2556,2557],{},"cascade"," — covered in full on ",[950,2560,681],{"href":2561},".\u002Fforeign-refs#declaring-refs",[959,2563,973],{}," respects whichever mode the field was declared with when a left record's FK value points at a target id that no longer exists:",[2566,2567,2568,2579,2598],"ul",{},[2569,2570,2571,2575,2576,1016],"li",{},[980,2572,2573],{},[959,2574,2549],{}," — throws ",[959,2577,2578],{},"DanglingReferenceError",[2569,2580,2581,2585,2586,2589,2590,2593,2594,2597],{},[980,2582,2583],{},[959,2584,2553],{}," — attaches ",[959,2587,2588],{},"client: null"," and emits a one-shot ",[959,2591,2592],{},"console.warn"," per unique dangling ",[959,2595,2596],{},"(field, target, id)"," triple.",[2569,2599,2600,2585,2604,2606],{},[980,2601,2602],{},[959,2603,2557],{},[959,2605,2588],{}," silently (cascade deletes are expected to clean these up; a dangling ref visible at read time is a mid-flight cascade or a pre-existing orphan, not a DSL error).",[1033,2608,2610],{"className":1035,"code":2609,"language":1037,"meta":1038,"style":1038},"const looseInvoices = vault.collection\u003CInvoice>('invoices-loose', {\n  refs: { clientId: ref('clients', 'warn') },\n})\nawait looseInvoices.put('inv-9', { id: 'inv-9', amount: 50, status: 'open', clientId: 'missing' })\n\nconst rows = looseInvoices.query()\n  .join\u003C'client', Client>('clientId', { as: 'client' })\n  .toArray()\n\u002F\u002F → [{ id: 'inv-9', amount: 50, status: 'open', clientId: 'missing', client: null }]\n\u002F\u002F console.warn: one-shot dangling-ref warning for clientId → clients\u002Fmissing\n",[959,2611,2612,2646,2680,2686,2758,2762,2778,2824,2832,2837],{"__ignoreMap":1038},[1042,2613,2614,2616,2619,2621,2623,2625,2627,2629,2631,2633,2635,2637,2640,2642,2644],{"class":1044,"line":1045},[1042,2615,1252],{"class":1113},[1042,2617,2618],{"class":1056}," looseInvoices ",[1042,2620,1258],{"class":1052},[1042,2622,1362],{"class":1056},[1042,2624,1016],{"class":1052},[1042,2626,953],{"class":1264},[1042,2628,1369],{"class":1052},[1042,2630,1406],{"class":1117},[1042,2632,1375],{"class":1052},[1042,2634,1267],{"class":1056},[1042,2636,1157],{"class":1052},[1042,2638,2639],{"class":1075},"invoices-loose",[1042,2641,1157],{"class":1052},[1042,2643,1060],{"class":1052},[1042,2645,1422],{"class":1052},[1042,2647,2648,2650,2652,2654,2656,2658,2660,2662,2664,2666,2668,2670,2672,2674,2676,2678],{"class":1044,"line":1082},[1042,2649,1428],{"class":1126},[1042,2651,1031],{"class":1052},[1042,2653,1053],{"class":1052},[1042,2655,1235],{"class":1126},[1042,2657,1031],{"class":1052},[1042,2659,1063],{"class":1264},[1042,2661,1267],{"class":1056},[1042,2663,1157],{"class":1052},[1042,2665,969],{"class":1075},[1042,2667,1157],{"class":1052},[1042,2669,1060],{"class":1052},[1042,2671,1072],{"class":1052},[1042,2673,2553],{"class":1075},[1042,2675,1157],{"class":1052},[1042,2677,1449],{"class":1056},[1042,2679,1452],{"class":1052},[1042,2681,2682,2684],{"class":1044,"line":1103},[1042,2683,1458],{"class":1052},[1042,2685,1313],{"class":1056},[1042,2687,2688,2690,2693,2695,2697,2699,2701,2704,2706,2708,2710,2712,2714,2716,2718,2720,2722,2724,2726,2729,2731,2733,2735,2737,2739,2741,2743,2745,2747,2749,2752,2754,2756],{"class":1044,"line":1110},[1042,2689,1498],{"class":1048},[1042,2691,2692],{"class":1056}," looseInvoices",[1042,2694,1016],{"class":1052},[1042,2696,1506],{"class":1264},[1042,2698,1267],{"class":1056},[1042,2700,1157],{"class":1052},[1042,2702,2703],{"class":1075},"inv-9",[1042,2705,1157],{"class":1052},[1042,2707,1060],{"class":1052},[1042,2709,1053],{"class":1052},[1042,2711,1127],{"class":1126},[1042,2713,1031],{"class":1052},[1042,2715,1072],{"class":1052},[1042,2717,2703],{"class":1075},[1042,2719,1157],{"class":1052},[1042,2721,1060],{"class":1052},[1042,2723,1193],{"class":1126},[1042,2725,1031],{"class":1052},[1042,2727,2728],{"class":1601}," 50",[1042,2730,1060],{"class":1052},[1042,2732,1203],{"class":1126},[1042,2734,1031],{"class":1052},[1042,2736,1072],{"class":1052},[1042,2738,1219],{"class":1075},[1042,2740,1157],{"class":1052},[1042,2742,1060],{"class":1052},[1042,2744,1235],{"class":1126},[1042,2746,1031],{"class":1052},[1042,2748,1072],{"class":1052},[1042,2750,2751],{"class":1075},"missing",[1042,2753,1157],{"class":1052},[1042,2755,1066],{"class":1052},[1042,2757,1313],{"class":1056},[1042,2759,2760],{"class":1044,"line":1173},[1042,2761,1107],{"emptyLinePlaceholder":1106},[1042,2763,2764,2766,2768,2770,2772,2774,2776],{"class":1044,"line":1244},[1042,2765,1252],{"class":1113},[1042,2767,2296],{"class":1056},[1042,2769,1258],{"class":1052},[1042,2771,2692],{"class":1056},[1042,2773,1016],{"class":1052},[1042,2775,1650],{"class":1264},[1042,2777,1653],{"class":1056},[1042,2779,2780,2782,2784,2786,2788,2790,2792,2794,2796,2798,2800,2802,2804,2806,2808,2810,2812,2814,2816,2818,2820,2822],{"class":1044,"line":1249},[1042,2781,1658],{"class":1052},[1042,2783,1696],{"class":1264},[1042,2785,1369],{"class":1052},[1042,2787,1157],{"class":1052},[1042,2789,1703],{"class":1075},[1042,2791,1157],{"class":1052},[1042,2793,1060],{"class":1052},[1042,2795,1118],{"class":1117},[1042,2797,1375],{"class":1052},[1042,2799,1267],{"class":1056},[1042,2801,1157],{"class":1052},[1042,2803,965],{"class":1075},[1042,2805,1157],{"class":1052},[1042,2807,1060],{"class":1052},[1042,2809,1053],{"class":1052},[1042,2811,1726],{"class":1126},[1042,2813,1031],{"class":1052},[1042,2815,1072],{"class":1052},[1042,2817,1703],{"class":1075},[1042,2819,1157],{"class":1052},[1042,2821,1066],{"class":1052},[1042,2823,1313],{"class":1056},[1042,2825,2826,2828,2830],{"class":1044,"line":1316},[1042,2827,1658],{"class":1052},[1042,2829,1745],{"class":1264},[1042,2831,1653],{"class":1056},[1042,2833,2834],{"class":1044,"line":1347},[1042,2835,2836],{"class":1752},"\u002F\u002F → [{ id: 'inv-9', amount: 50, status: 'open', clientId: 'missing', client: null }]\n",[1042,2838,2839],{"class":1044,"line":1352},[1042,2840,2841],{"class":1752},"\u002F\u002F console.warn: one-shot dangling-ref warning for clientId → clients\u002Fmissing\n",[946,2843,2844,2845,2848,2849,2852],{},"A FK field that is ",[959,2846,2847],{},"null"," or ",[959,2850,2851],{},"undefined"," is not a dangling ref — it's \"no reference at all\", and is always allowed regardless of mode.",[1466,2854,2856],{"id":2855},"reactive-joins","Reactive joins",[946,2858,2859,2862,2863,2866,2867,2870,2871,2874],{},[959,2860,2861],{},"query.live()"," returns a ",[959,2864,2865],{},"LiveQuery"," that re-runs the query and updates ",[959,2868,2869],{},".value"," whenever a source changes. For a joined query it subscribes to the left collection ",[980,2872,2873],{},"and"," every join target, deduplicated by collection name — so a client update re-fires an invoice query that joined that client:",[1033,2876,2878],{"className":1035,"code":2877,"language":1037,"meta":1038,"style":1038},"const live = await invoices.query()\n  .join\u003C'client', Client>('clientId', { as: 'client' })\n  .live()\n\nlive.subscribe(() => render(live.value))\n\nawait clients.put('cli-A', { id: 'cli-A', name: 'Acme Corporation', tier: 'premium' })\n\u002F\u002F → live.value[0].client.name is now \"Acme Corporation\" — the right-side put re-fired the query\n\nlive.stop()\n",[959,2879,2880,2899,2945,2953,2957,2983,2987,3048,3053,3057],{"__ignoreMap":1038},[1042,2881,2882,2884,2887,2889,2891,2893,2895,2897],{"class":1044,"line":1045},[1042,2883,1252],{"class":1113},[1042,2885,2886],{"class":1056}," live ",[1042,2888,1258],{"class":1052},[1042,2890,1261],{"class":1048},[1042,2892,1565],{"class":1056},[1042,2894,1016],{"class":1052},[1042,2896,1650],{"class":1264},[1042,2898,1653],{"class":1056},[1042,2900,2901,2903,2905,2907,2909,2911,2913,2915,2917,2919,2921,2923,2925,2927,2929,2931,2933,2935,2937,2939,2941,2943],{"class":1044,"line":1082},[1042,2902,1658],{"class":1052},[1042,2904,1696],{"class":1264},[1042,2906,1369],{"class":1052},[1042,2908,1157],{"class":1052},[1042,2910,1703],{"class":1075},[1042,2912,1157],{"class":1052},[1042,2914,1060],{"class":1052},[1042,2916,1118],{"class":1117},[1042,2918,1375],{"class":1052},[1042,2920,1267],{"class":1056},[1042,2922,1157],{"class":1052},[1042,2924,965],{"class":1075},[1042,2926,1157],{"class":1052},[1042,2928,1060],{"class":1052},[1042,2930,1053],{"class":1052},[1042,2932,1726],{"class":1126},[1042,2934,1031],{"class":1052},[1042,2936,1072],{"class":1052},[1042,2938,1703],{"class":1075},[1042,2940,1157],{"class":1052},[1042,2942,1066],{"class":1052},[1042,2944,1313],{"class":1056},[1042,2946,2947,2949,2951],{"class":1044,"line":1103},[1042,2948,1658],{"class":1052},[1042,2950,727],{"class":1264},[1042,2952,1653],{"class":1056},[1042,2954,2955],{"class":1044,"line":1110},[1042,2956,1107],{"emptyLinePlaceholder":1106},[1042,2958,2959,2961,2963,2966,2968,2970,2972,2975,2978,2980],{"class":1044,"line":1173},[1042,2960,727],{"class":1056},[1042,2962,1016],{"class":1052},[1042,2964,2965],{"class":1264},"subscribe",[1042,2967,1267],{"class":1056},[1042,2969,1280],{"class":1052},[1042,2971,2505],{"class":1113},[1042,2973,2974],{"class":1264}," render",[1042,2976,2977],{"class":1056},"(live",[1042,2979,1016],{"class":1052},[1042,2981,2982],{"class":1056},"value))\n",[1042,2984,2985],{"class":1044,"line":1244},[1042,2986,1107],{"emptyLinePlaceholder":1106},[1042,2988,2989,2991,2993,2995,2997,2999,3001,3003,3005,3007,3009,3011,3013,3015,3017,3019,3021,3023,3025,3027,3030,3032,3034,3036,3038,3040,3042,3044,3046],{"class":1044,"line":1249},[1042,2990,1498],{"class":1048},[1042,2992,1501],{"class":1056},[1042,2994,1016],{"class":1052},[1042,2996,1506],{"class":1264},[1042,2998,1267],{"class":1056},[1042,3000,1157],{"class":1052},[1042,3002,1513],{"class":1075},[1042,3004,1157],{"class":1052},[1042,3006,1060],{"class":1052},[1042,3008,1053],{"class":1052},[1042,3010,1127],{"class":1126},[1042,3012,1031],{"class":1052},[1042,3014,1072],{"class":1052},[1042,3016,1513],{"class":1075},[1042,3018,1157],{"class":1052},[1042,3020,1060],{"class":1052},[1042,3022,1138],{"class":1126},[1042,3024,1031],{"class":1052},[1042,3026,1072],{"class":1052},[1042,3028,3029],{"class":1075},"Acme Corporation",[1042,3031,1157],{"class":1052},[1042,3033,1060],{"class":1052},[1042,3035,1147],{"class":1126},[1042,3037,1031],{"class":1052},[1042,3039,1072],{"class":1052},[1042,3041,1165],{"class":1075},[1042,3043,1157],{"class":1052},[1042,3045,1066],{"class":1052},[1042,3047,1313],{"class":1056},[1042,3049,3050],{"class":1044,"line":1316},[1042,3051,3052],{"class":1752},"\u002F\u002F → live.value[0].client.name is now \"Acme Corporation\" — the right-side put re-fired the query\n",[1042,3054,3055],{"class":1044,"line":1347},[1042,3056,1107],{"emptyLinePlaceholder":1106},[1042,3058,3059,3061,3063,3066],{"class":1044,"line":1352},[1042,3060,727],{"class":1056},[1042,3062,1016],{"class":1052},[1042,3064,3065],{"class":1264},"stop",[1042,3067,1653],{"class":1056},[946,3069,3070,3071,3073,3074,3076,3077,3080,3081,3083,3084,3087,3088,3091],{},"Under ",[959,3072,2549],{}," mode, a right-side delete that leaves a dangling ref makes the re-run throw; ",[959,3075,2865],{}," catches it and stores it on ",[959,3078,3079],{},".error"," instead of tearing down the subscription — check ",[959,3082,3079],{}," after each notification. Always call ",[959,3085,3086],{},".stop()"," when you're done; it tears down every upstream subscription. See ",[950,3089,727],{"href":3090},".\u002Flive"," for the reactive primitive itself.",[941,3093,3095],{"id":3094},"api","API",[1466,3097,3099],{"id":3098},"queryjoinfield-opts",[959,3100,3101],{},"query.join(field, opts)",[1033,3103,3105],{"className":1035,"code":3104,"language":1037,"meta":1038,"style":1038},"join\u003CAs extends string, Right = unknown>(\n  field: string,\n  opts: { as: As; strategy?: 'hash' | 'nested'; maxRows?: number }\n): Query\u003CT & Record\u003CAs, Right | null>>\n",[959,3106,3107,3131,3138,3181],{"__ignoreMap":1038},[1042,3108,3109,3111,3113,3116,3118,3121,3123,3126,3128],{"class":1044,"line":1045},[1042,3110,1696],{"class":1056},[1042,3112,1369],{"class":1052},[1042,3114,3115],{"class":1056},"As extends string",[1042,3117,1060],{"class":1052},[1042,3119,3120],{"class":1056}," Right ",[1042,3122,1258],{"class":1052},[1042,3124,3125],{"class":1056}," unknown",[1042,3127,1375],{"class":1052},[1042,3129,3130],{"class":1056},"(\n",[1042,3132,3133,3136],{"class":1044,"line":1082},[1042,3134,3135],{"class":1056},"  field: string",[1042,3137,1792],{"class":1052},[1042,3139,3140,3143,3145,3147,3149,3152,3155,3157,3159,3161,3163,3165,3168,3170,3173,3175,3178],{"class":1044,"line":1103},[1042,3141,3142],{"class":1056},"  opts: ",[1042,3144,1270],{"class":1052},[1042,3146,1726],{"class":1126},[1042,3148,1031],{"class":1052},[1042,3150,3151],{"class":1056}," As; strategy",[1042,3153,3154],{"class":1052},"?:",[1042,3156,1072],{"class":1052},[1042,3158,1948],{"class":1075},[1042,3160,1157],{"class":1052},[1042,3162,1160],{"class":1052},[1042,3164,1072],{"class":1052},[1042,3166,3167],{"class":1075},"nested",[1042,3169,1157],{"class":1052},[1042,3171,3172],{"class":1056},"; maxRows",[1042,3174,3154],{"class":1052},[1042,3176,3177],{"class":1056}," number ",[1042,3179,3180],{"class":1052},"}\n",[1042,3182,3183,3186,3188,3191,3194,3197,3199,3202,3204,3206,3209],{"class":1044,"line":1110},[1042,3184,3185],{"class":1056},"): Query",[1042,3187,1369],{"class":1052},[1042,3189,3190],{"class":1056},"T ",[1042,3192,3193],{"class":1052},"&",[1042,3195,3196],{"class":1056}," Record",[1042,3198,1369],{"class":1052},[1042,3200,3201],{"class":1056},"As",[1042,3203,1060],{"class":1052},[1042,3205,3120],{"class":1056},[1042,3207,3208],{"class":1052},"|",[1042,3210,3211],{"class":1052}," null>>\n",[946,3213,3214,3215,3217,3218,3221,3222,3225,3226,3229,3230,3232,3233,3235,3236,3239],{},"Resolves the ",[959,3216,961],{}," declared on ",[959,3219,3220],{},"field"," and attaches the target record under ",[959,3223,3224],{},"opts.as",". Returns a new immutable ",[959,3227,3228],{},"Query"," — the original is unchanged. Throws if the query wasn't built via ",[959,3231,1015],{}," (no join context), or if ",[959,3234,3220],{}," has no matching ",[959,3237,3238],{},"refs: { [field]: ref(...) }"," declaration.",[1033,3241,3243],{"className":1035,"code":3242,"language":1037,"meta":1038,"style":1038},"const rows = invoices.query().join\u003C'client', Client>('clientId', { as: 'client' }).toArray()\n\u002F\u002F → [{ ...invoice, client: Client | null }, ...]\n",[959,3244,3245,3311],{"__ignoreMap":1038},[1042,3246,3247,3249,3251,3253,3255,3257,3259,3261,3263,3265,3267,3269,3271,3273,3275,3277,3279,3281,3283,3285,3287,3289,3291,3293,3295,3297,3299,3301,3303,3305,3307,3309],{"class":1044,"line":1045},[1042,3248,1252],{"class":1113},[1042,3250,2296],{"class":1056},[1042,3252,1258],{"class":1052},[1042,3254,1565],{"class":1056},[1042,3256,1016],{"class":1052},[1042,3258,1650],{"class":1264},[1042,3260,1280],{"class":1056},[1042,3262,1016],{"class":1052},[1042,3264,1696],{"class":1264},[1042,3266,1369],{"class":1052},[1042,3268,1157],{"class":1052},[1042,3270,1703],{"class":1075},[1042,3272,1157],{"class":1052},[1042,3274,1060],{"class":1052},[1042,3276,1118],{"class":1117},[1042,3278,1375],{"class":1052},[1042,3280,1267],{"class":1056},[1042,3282,1157],{"class":1052},[1042,3284,965],{"class":1075},[1042,3286,1157],{"class":1052},[1042,3288,1060],{"class":1052},[1042,3290,1053],{"class":1052},[1042,3292,1726],{"class":1126},[1042,3294,1031],{"class":1052},[1042,3296,1072],{"class":1052},[1042,3298,1703],{"class":1075},[1042,3300,1157],{"class":1052},[1042,3302,1066],{"class":1052},[1042,3304,2121],{"class":1056},[1042,3306,1016],{"class":1052},[1042,3308,1745],{"class":1264},[1042,3310,1653],{"class":1056},[1042,3312,3313],{"class":1044,"line":1082},[1042,3314,3315],{"class":1752},"\u002F\u002F → [{ ...invoice, client: Client | null }, ...]\n",[3317,3318,3319,3338],"table",{},[3320,3321,3322],"thead",{},[3323,3324,3325,3329,3332,3335],"tr",{},[3326,3327,3328],"th",{},"Option",[3326,3330,3331],{},"Type",[3326,3333,3334],{},"Default",[3326,3336,3337],{},"Purpose",[3339,3340,3341,3359,3377],"tbody",{},[3323,3342,3343,3348,3353,3356],{},[3344,3345,3346],"td",{},[959,3347,1478],{},[3344,3349,3350],{},[959,3351,3352],{},"string",[3344,3354,3355],{},"required",[3344,3357,3358],{},"Field name the joined record is attached under.",[3323,3360,3361,3366,3371,3374],{},[3344,3362,3363],{},[959,3364,3365],{},"strategy",[3344,3367,3368],{},[959,3369,3370],{},"'hash' | 'nested'",[3344,3372,3373],{},"auto-selected",[3344,3375,3376],{},"Force the join planner's strategy; mainly useful for tests.",[3323,3378,3379,3384,3389,3401],{},[3344,3380,3381],{},[959,3382,3383],{},"maxRows",[3344,3385,3386],{},[959,3387,3388],{},"number",[3344,3390,3391,3394,3395,3398,3399,2121],{},[959,3392,3393],{},"50_000"," (",[959,3396,3397],{},"DEFAULT_JOIN_MAX_ROWS",", exported from ",[959,3400,1076],{},[3344,3402,3403],{},"Per-leg row ceiling — see below.",[946,3405,1959,3406,3408],{},[959,3407,973],{}," again to resolve additional FKs on the same left record — each call adds one alias to the result type.",[1466,3410,3412],{"id":3411},"errors","Errors",[946,3414,3415,3416,1031],{},"Both are importable from ",[959,3417,1076],{},[2566,3419,3420,3447],{},[2569,3421,3422,3427,3428,3431,3432,3394,3435,3438,3439,2554,3442,2554,3445,1016],{},[980,3423,3424],{},[959,3425,3426],{},"JoinTooLargeError"," (code ",[959,3429,3430],{},"JOIN_TOO_LARGE",") — either side of a join leg exceeds the row ceiling. Carries ",[959,3433,3434],{},"side",[959,3436,3437],{},"'left' | 'right'","), ",[959,3440,3441],{},"leftRows",[959,3443,3444],{},"rightRows",[959,3446,3383],{},[2569,3448,3449,3427,3453,3456,3457,3459,3460,2554,3462,2554,3465,1016],{},[980,3450,3451],{},[959,3452,2578],{},[959,3454,3455],{},"DANGLING_REFERENCE",") — a ",[959,3458,2549],{},"-mode ref points at a target id that doesn't exist. Carries ",[959,3461,3220],{},[959,3463,3464],{},"target",[959,3466,3467],{},"refId",[941,3469,3471],{"id":3470},"limits-gotchas","Limits & gotchas",[2566,3473,3474,3487,3500,3516,3530],{},[2569,3475,3476,3479,3480,3482,3483,3486],{},[980,3477,3478],{},"Row ceiling, checked before allocation."," ",[959,3481,3426],{}," fires at 50,000 rows per side by default; override per-call with ",[959,3484,3485],{},"{ maxRows }"," if you've measured the query is safe larger.",[2569,3488,3489,3492,3493,3496,3497,3499],{},[980,3490,3491],{},"Same vault only."," A join target must be reachable in the same vault; there is no cross-vault join — use ",[959,3494,3495],{},"db.queryAcross()"," for that (see ",[950,3498,1487],{"href":1486},").",[2569,3501,3502,3479,3507,3510,3511,3235,3513,3515],{},[980,3503,3504,3506],{},[959,3505,961],{}," required.",[959,3508,3509],{},".join(field, ...)"," throws if ",[959,3512,3220],{},[959,3514,3238],{}," declaration on the left collection — it does not infer relationships.",[2569,3517,3518,3521,3522,3525,3526,3529],{},[980,3519,3520],{},"Partition-awareness is plumbed but dormant."," Every join leg internally carries a ",[959,3523,3524],{},"partitionScope"," field that is always ",[959,3527,3528],{},"'all'"," today; the executor doesn't read it yet.",[2569,3531,3532,3541,3542,3545],{},[980,3533,3534,3537,3538,3540],{},[959,3535,3536],{},".live()"," on ",[959,3539,2549],{},"-mode joins can error."," A right-side delete that leaves a dangling ref makes the live re-run throw; the error surfaces on ",[959,3543,3544],{},"LiveQuery.error"," rather than propagating out of the change handler.",[941,3547,3549],{"id":3548},"see-also","See also",[2566,3551,3552,3560,3565,3571,3578,3586,3603],{},[2569,3553,3554,3556,3557,3559],{},[950,3555,681],{"href":957}," — declaring ",[959,3558,961],{}," and the three enforcement modes",[2569,3561,3562,3564],{},[950,3563,657],{"href":993}," — pairing rows with no declared reference between them",[2569,3566,3567,3570],{},[950,3568,705],{"href":3569},".\u002Findexing"," — the indexed nested-loop join strategy uses a collection's index on the join field",[2569,3572,3573,3577],{},[950,3574,3576],{"href":3575},".\u002Freduce","aggregate"," — joined rows can be grouped and aggregated",[2569,3579,3580,3582,3583,3585],{},[950,3581,727],{"href":3090}," — the reactive primitive ",[959,3584,3536],{}," returns",[2569,3587,3588,3591,3592,3594,3595,3594,3597,3600,3601],{},[950,3589,3590],{"href":1486},"Query basics"," — ",[959,3593,1661],{}," \u002F ",[959,3596,2496],{},[959,3598,3599],{},"orderBy"," and ",[959,3602,3495],{},[2569,3604,3605,3606,1016],{},"Proven by showcase ",[950,3607,3611],{"href":3608,"rel":3609},"https:\u002F\u002Fgithub.com\u002Fnoy-db\u002Fdocs\u002Fblob\u002Fmain\u002Fshowcases\u002Fsrc\u002F12-with-joins.showcase.test.ts",[3610],"nofollow",[959,3612,3613],{},"12-with-joins",[3615,3616,3617],"style",{},"html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .sHdIc, html code.shiki .sHdIc{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#EEFFFF;--shiki-default-font-style:italic;--shiki-dark:#BABED8;--shiki-dark-font-style:italic}",{"title":1038,"searchDepth":1103,"depth":1103,"links":3619},[3620,3621,3622,3628,3632,3633],{"id":943,"depth":1082,"text":944},{"id":1019,"depth":1082,"text":1020},{"id":1463,"depth":1082,"text":1464,"children":3623},[3624,3625,3626,3627],{"id":1468,"depth":1103,"text":1469},{"id":1955,"depth":1103,"text":1956},{"id":2540,"depth":1103,"text":2541},{"id":2855,"depth":1103,"text":2856},{"id":3094,"depth":1082,"text":3095,"children":3629},[3630,3631],{"id":3098,"depth":1103,"text":3101},{"id":3411,"depth":1103,"text":3412},{"id":3470,"depth":1082,"text":3471},{"id":3548,"depth":1082,"text":3549},null,"Eager foreign-key joins in the query DSL: attach a referenced record under an alias, chain joins, and keep the result live as either side changes.","md",{},"service",{"title":715,"description":3635},"stable","important","bNxiSmjDQ7viYAL7b__CUilATQ9mx6fqZymjVo-gaDQ",{"data":3644,"body":3645},{},{"type":3646,"children":3647},"root",[3648],{"type":3649,"tag":946,"props":3650,"children":3651},"element",{},[3652],{"type":3649,"tag":3653,"props":3654,"children":3655},"em",{},[3656,3659,3664],{"type":3657,"value":3658},"text","(currently always-core; a dedicated ",{"type":3649,"tag":959,"props":3660,"children":3662},{"className":3661},[],[3663],{"type":3657,"value":1004},{"type":3657,"value":3665}," subpath is a planned follow-up)",{"data":3667,"body":3668},{},{"type":3646,"children":3669},[3670],{"type":3649,"tag":946,"props":3671,"children":3672},{},[3673,3678,3679],{"type":3649,"tag":959,"props":3674,"children":3676},{"className":3675},[],[3677],{"type":3657,"value":1008},{"type":3657,"value":3479},{"type":3649,"tag":3653,"props":3680,"children":3681},{},[3682],{"type":3657,"value":3683},"(planned)",{"data":3685,"body":3686},{},{"type":3646,"children":3687},[3688],{"type":3649,"tag":946,"props":3689,"children":3690},{},[3691],{"type":3657,"value":3692},"A — Read & Query",1791896582537]