@lunora/codegen 1.0.0-alpha.25 → 1.0.0-alpha.250
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE.md +6 -0
- package/README.md +1 -1
- package/dist/index.d.mts +3755 -1247
- package/dist/index.d.ts +3755 -1247
- package/dist/index.mjs +1 -34
- package/dist/packem_shared/AGENTS_FILENAME-D8SgT3OR.mjs +1 -0
- package/dist/packem_shared/CONTAINERS_FILENAME-C13yKxas.mjs +1 -0
- package/dist/packem_shared/CodegenDiagnosticError-BUXlG3P-.mjs +1 -0
- package/dist/packem_shared/DEFAULT_TARGET-vMWzRzRF.mjs +1 -0
- package/dist/packem_shared/FLAGS_FILENAME-W5XQz_Po.mjs +1 -0
- package/dist/packem_shared/GENERATED_HEADER-DSXl0YM2.mjs +1 -0
- package/dist/packem_shared/LUNORA_ERROR_CODES-C2s0xWQD.mjs +1 -0
- package/dist/packem_shared/MUTATORS_FILENAME-DqWOgC5Z.mjs +1 -0
- package/dist/packem_shared/NOTIFY_FILENAME-C1J_47et.mjs +1 -0
- package/dist/packem_shared/OPENRPC_VERSION-Cr7Zzp6s.mjs +3 -0
- package/dist/packem_shared/PROJECT_CONFIG_FILENAMES-DzOu-lSc.mjs +1 -0
- package/dist/packem_shared/QUEUES_FILENAME-RGwht3Xu.mjs +1 -0
- package/dist/packem_shared/SCHEMA_SNAPSHOT_FILENAME-jefy8GTn.mjs +11 -0
- package/dist/packem_shared/SCHEMA_SNAPSHOT_VERSION-C0oHwiJZ.mjs +2 -0
- package/dist/packem_shared/SDK_LANGUAGES-Df_CnJx5.mjs +372 -0
- package/dist/packem_shared/SHAPES_FILENAME-DRUFomCj.mjs +1 -0
- package/dist/packem_shared/SchemaSnapshotParseError-CPOXlFhI.mjs +18 -0
- package/dist/packem_shared/WORKFLOWS_FILENAME-4-ib4HH-.mjs +1 -0
- package/dist/packem_shared/buildOpenApiDocument-SxfElVzK.mjs +3 -0
- package/dist/packem_shared/capabilities-CqnIsyA9.mjs +20 -0
- package/dist/packem_shared/chain-mte5djRJ.mjs +1 -0
- package/dist/packem_shared/classify-procedure-call-CmcShAze.mjs +1 -0
- package/dist/packem_shared/context-property-calls-CWf9-6G5.mjs +1 -0
- package/dist/packem_shared/contextPropertiesRead-BGy4tGCY.mjs +1 -0
- package/dist/packem_shared/declared-output-Iaar469J.mjs +1 -0
- package/dist/packem_shared/describeErrorLevelFindings-vzaGS9KL.mjs +1 -0
- package/dist/packem_shared/discoverAuthApiCalls-DoSN_yc3.mjs +1 -0
- package/dist/packem_shared/discoverCrons-BEALHx1S.mjs +1 -0
- package/dist/packem_shared/discoverFunctions-BcBzcG5x.mjs +1 -0
- package/dist/packem_shared/discoverHttpRoutes-CJHS4llq.mjs +1 -0
- package/dist/packem_shared/discoverHyperdriveCalls-Bkbh4tG7.mjs +1 -0
- package/dist/packem_shared/discoverInserts-DpuLYPPd.mjs +1 -0
- package/dist/packem_shared/discoverMaskProcedures-B0w8gM0S.mjs +1 -0
- package/dist/packem_shared/discoverMigrations-Dt7ywfZv.mjs +1 -0
- package/dist/packem_shared/discoverNondeterministicCalls-CNJV2BiP.mjs +1 -0
- package/dist/packem_shared/discoverQueries-BcdqjYky.mjs +1 -0
- package/dist/packem_shared/discoverR2sqlCalls-30Wtbc0P.mjs +1 -0
- package/dist/packem_shared/discoverRlsMetadata-mXBmPOGj.mjs +1 -0
- package/dist/packem_shared/discoverRlsProcedures-F4Cy-kSi.mjs +1 -0
- package/dist/packem_shared/discoverSandboxUsage-BnsPld5I.mjs +1 -0
- package/dist/packem_shared/discoverSchema-D5R60b4F.mjs +1 -0
- package/dist/packem_shared/discoverStorageRulesMetadata-D3Ot9g5f.mjs +1 -0
- package/dist/packem_shared/emitAgents-3XP5C-VJ.mjs +1 -0
- package/dist/packem_shared/emitApi-DdW9RyGG.mjs +154 -0
- package/dist/packem_shared/emitApp-T_My13i6.mjs +860 -0
- package/dist/packem_shared/emitCrons-BRKXFGFu.mjs +83 -0
- package/dist/packem_shared/emitDataModel-D3WuEZ4b.mjs +113 -0
- package/dist/packem_shared/emitDrizzleSchema-Cv0HtLR3.mjs +15 -0
- package/dist/packem_shared/emitFunctions-BgNeOZt_.mjs +249 -0
- package/dist/packem_shared/emitServer-DQxwHVPM.mjs +374 -0
- package/dist/packem_shared/emitShard-BDfiH_JF.mjs +1 -0
- package/dist/packem_shared/exported-procedure-chains-D48EXUVQ.mjs +1 -0
- package/dist/packem_shared/fingerprintSchemaSources-Cl1CJFeh.mjs +1 -0
- package/dist/packem_shared/formatAdvisories-DwmUKYuc.mjs +2 -0
- package/dist/packem_shared/index-D7dKfGPh.mjs +1 -0
- package/dist/packem_shared/ir-DBSvhNa-.mjs +1 -0
- package/dist/packem_shared/isD1GlobalTable-udvHAAzD.mjs +1 -0
- package/dist/packem_shared/isTypedSchema-CKzc3ioR.mjs +4 -0
- package/dist/packem_shared/json-data-Chfs2Cz5.mjs +1 -0
- package/dist/packem_shared/listLunoraSourceFiles-CSlcBYlo.mjs +1 -0
- package/dist/packem_shared/loadProjectConfig-nNIDOrlR.mjs +1 -0
- package/dist/packem_shared/module-specifiers-WF8iAydP.mjs +1 -0
- package/dist/packem_shared/modules-DyCocr1e.mjs +1 -0
- package/dist/packem_shared/parse-validator-C6fHL7OS.mjs +1 -0
- package/dist/packem_shared/paths-C-9fwEgQ.mjs +1 -0
- package/dist/packem_shared/qualifiers-BhOL15WZ.mjs +1 -0
- package/dist/packem_shared/readPackageDependencies-C6h6FZuP.mjs +1 -0
- package/dist/packem_shared/readServiceBindings-CeQvSswr.mjs +1 -0
- package/dist/packem_shared/redact-Cy14LEnc.mjs +1 -0
- package/dist/packem_shared/schemaFromIr-BWFnvCVg.mjs +1 -0
- package/dist/packem_shared/shard-f7coQFS9.mjs +1435 -0
- package/dist/packem_shared/shard-runtime-CyEbIjPA.mjs +321 -0
- package/dist/packem_shared/shared-DjUziztz.mjs +9 -0
- package/dist/packem_shared/unwrap-handler-return-DVY_kFF7.mjs +1 -0
- package/package.json +16 -7
- package/dist/packem_shared/CONTAINERS_FILENAME-DlP6YM_Q.mjs +0 -224
- package/dist/packem_shared/CodegenDiagnosticError-DeblMkzO.mjs +0 -23
- package/dist/packem_shared/FLAGS_FILENAME-B1vE0LIo.mjs +0 -139
- package/dist/packem_shared/GENERATED_HEADER-BullHnLo.mjs +0 -3265
- package/dist/packem_shared/LUNORA_ERROR_CODES-CySpQPD3.mjs +0 -61
- package/dist/packem_shared/LUNORA_SOLUTION_RULES-BTejmZp-.mjs +0 -131
- package/dist/packem_shared/MUTATORS_FILENAME-BhqdPtKp.mjs +0 -81
- package/dist/packem_shared/OPENRPC_VERSION-D7MAVX3K.mjs +0 -60
- package/dist/packem_shared/QUEUES_FILENAME-B5_eWCRe.mjs +0 -119
- package/dist/packem_shared/SCHEMA_SNAPSHOT_FILENAME-BAcxxSdB.mjs +0 -1130
- package/dist/packem_shared/SCHEMA_SNAPSHOT_VERSION-wWGP2_5E.mjs +0 -245
- package/dist/packem_shared/SHAPES_FILENAME-ChV7MqgE.mjs +0 -94
- package/dist/packem_shared/WORKFLOWS_FILENAME-CCisG0Vy.mjs +0 -124
- package/dist/packem_shared/buildOpenApiDocument-Bm56LsBb.mjs +0 -183
- package/dist/packem_shared/discover-ast-CT6BgBr4.mjs +0 -13
- package/dist/packem_shared/discoverAuthApiCalls-CoirYbg6.mjs +0 -62
- package/dist/packem_shared/discoverCrons-Cev7RRAf.mjs +0 -257
- package/dist/packem_shared/discoverFunctions-BWMczzBx.mjs +0 -465
- package/dist/packem_shared/discoverHttpRoutes-CfP6cMzt.mjs +0 -131
- package/dist/packem_shared/discoverInserts-C7zxXkUf.mjs +0 -61
- package/dist/packem_shared/discoverMaskProcedures-Cm81kwrb.mjs +0 -217
- package/dist/packem_shared/discoverMigrations-Bi5nJ0mJ.mjs +0 -97
- package/dist/packem_shared/discoverNondeterministicCalls-C4M8AXmQ.mjs +0 -122
- package/dist/packem_shared/discoverQueries-B0wGT-xe.mjs +0 -62
- package/dist/packem_shared/discoverR2sqlCalls-BVNMd428.mjs +0 -80
- package/dist/packem_shared/discoverRlsMetadata-BS9GOGC5.mjs +0 -280
- package/dist/packem_shared/discoverSchema-KYq55qu3.mjs +0 -864
- package/dist/packem_shared/discoverStorageRulesMetadata-Da8BKXcI.mjs +0 -97
- package/dist/packem_shared/emitApp-BUN7hhlY.mjs +0 -666
- package/dist/packem_shared/formatAdvisories-DdjK7sgh.mjs +0 -81
- package/dist/packem_shared/parse-validator-Cabb60UV.mjs +0 -133
- package/dist/packem_shared/paths-BRd6JHuF.mjs +0 -11
- package/dist/packem_shared/schemaFromIr-DTYsLBaA.mjs +0 -57
|
@@ -0,0 +1,372 @@
|
|
|
1
|
+
import{modelSources as pe,assertDistinctMembers as T,toPascalCase as l,referencedModels as W,generatedHeaderLines as f,commentText as p,argsChoice as $,stringLiteral as m,kotlinLiteral as w,allMethods as x,toSnakeCase as E,parseSpec as Ne,assertGeneratable as Oe,withDeclaredModels as Ce,unrepresentableFunctions as Le,undeclaredModels as Re}from"./isTypedSchema-CKzc3ioR.mjs";import{isTypedSchema as St}from"./isTypedSchema-CKzc3ioR.mjs";const We=async(e,n)=>{if(n.quicktype===void 0)return"";const t=pe(e);if(t.length===0)return"";const{InputData:r,JSONSchemaInput:a,JSONSchemaStore:i,quicktype:o}=await import("quicktype-core");class s extends i{fetch(){return Promise.resolve(void 0)}}const d=new a(new s);for(const g of t)await d.addSource({name:g.name,schema:JSON.stringify(g.schema)});const c=new r;c.addInput(d);const{lines:u}=await o({inputData:c,lang:n.quicktype.lang,rendererOptions:n.quicktype.rendererOptions??{}});return u.join(`
|
|
2
|
+
`)},D=`${f("dart").map(e=>`// ${e}`).join(`
|
|
3
|
+
`)}
|
|
4
|
+
|
|
5
|
+
`,Me=`# GENERATED by \`lunora sdk generate --lang dart\` — do not edit.
|
|
6
|
+
#
|
|
7
|
+
# The transport is vendored under lib/, so this package has no dependencies and
|
|
8
|
+
# nothing to fetch. Add it to a consuming app as a path dependency — pub takes a
|
|
9
|
+
# path dependency's identity from the "name" below, NOT from the directory, so
|
|
10
|
+
# this is the name you write no matter where you generated into:
|
|
11
|
+
#
|
|
12
|
+
# dependencies:
|
|
13
|
+
# lunora_sdk:
|
|
14
|
+
# path: sdk/dart
|
|
15
|
+
#
|
|
16
|
+
# import 'package:lunora_sdk/lunora_api.dart';
|
|
17
|
+
name: lunora_sdk
|
|
18
|
+
description: Generated Lunora SDK, transport included.
|
|
19
|
+
version: 0.0.0
|
|
20
|
+
publish_to: none
|
|
21
|
+
|
|
22
|
+
environment:
|
|
23
|
+
sdk: ^3.6.0
|
|
24
|
+
`,De=new Set(["assert","break","case","catch","class","const","continue","default","do","else","enum","extends","false","final","finally","for","if","in","is","new","null","rethrow","return","super","switch","this","throw","true","try","var","void","while","with"]),j=e=>{const n=l(e),t=n.charAt(0).toLowerCase()+n.slice(1);return De.has(t)?`${t}_`:t},de=e=>m(e).replaceAll("$",String.raw`\$`),Pe=e=>e.replaceAll(" == null ? [] : List<"," == null ? null : List<").replaceAll(/Map\.from\((?<source>[^()]*?)!\)/gu,"$<source> == null ? null : Map.from($<source>!)"),Z=" ".repeat(8),Ve=/^class (\w+) \{/u,Ke=/^class \w+ \{\n[\s\S]*?\n\}$/gmu,Ie=/^ {4}\w+\(\{\n([\s\S]*?)^ {4}\}\);$/mu,xe=/^ {8}(?:required )?this\.\w+,$/gmu,Fe=/^ {4}Map<String, dynamic> toJson\(\) => \{\n([\s\S]*?)^ {4}\};$/mu,qe=/^ {8}"(?:[^\\"]|\\.)*": .*,$/gmu,Ue=e=>e.replaceAll(Ke,n=>{const[,t]=Ie.exec(n)??[],[,r]=Fe.exec(n)??[];if(t===void 0||r===void 0)return n;const a=[...t.matchAll(xe)].map(d=>{const c=d[0].trim();return{field:c.slice(c.indexOf("this.")+5,-1),optional:!c.startsWith("required ")}}),i=[...r.matchAll(qe)],o=a.filter(d=>d.optional);if(a.length!==i.length){if(o.length===0)return n;throw new Error(`dart models: cannot place the optional-field guards in ${Ve.exec(n)?.[1]??"a generated class"} — ${String(a.length)} constructor parameter(s) against ${String(i.length)} toJson entr(ies). quicktype's Dart output has changed shape; \`guardOptionalFields\` in targets/dart.ts must be updated to match.`)}let s=r;for(const[d,c]of i.entries()){const u=a[d];if(!u?.optional)continue;const g=c[0],ke=g.slice(Z.length).replace(`${u.field} == null ? null : `,"");s=s.replace(g,`${Z}if (${u.field} != null) ${ke}`)}return n.replace(r,s)}),$e=e=>$(e,{none:"null",typed:()=>"LunoraClient.wireValue(args)",untyped:"args"}),me={declaration:"LunoraOptimistic? optimistic, LunoraOptimisticUpdate? optimisticUpdate, bool Function()? precondition",forward:"optimistic: optimistic, optimisticUpdate: optimisticUpdate, precondition: precondition"},X=e=>{const n=e.verb==="mutation"?`{String? shardKey, ${me.declaration}}`:"{String? shardKey}";return $(e,{none:n,typed:t=>`${t} args, ${n}`,untyped:`Object? args, ${n}`})},ye=(e,n)=>`${e}.fromJson(${n} as Map<String, dynamic>)`,Q=e=>{const n=e.verb==="mutation"?`, ${me.forward}`:"",t=`_client.${e.verb}("${de(e.functionPath)}", args: ${$e(e)}, shardKey: shardKey${n})`;return e.resultType===void 0?[` /// ${p(e.summary)}`,` Future<Object?> ${j(e.functionName)}(${X(e)}) => ${t};`].join(`
|
|
25
|
+
`):[` /// ${p(e.summary)}`,` Future<${e.resultType}> ${j(e.functionName)}(${X(e)}) async =>`,` ${ye(e.resultType,`await ${t}`)};`].join(`
|
|
26
|
+
`)},He=e=>{const n=$(e,{none:"",typed:o=>`${o} args`,untyped:"Object? args"}),t=n===""?"":`${n}, `,r=$e(e),a=`"${de(e.functionPath)}"`,i=`_client.watch(${a}, args: ${r})`;return[` /// live ${p(e.summary)} — re-runs on every write to the tables it reads.`,` LunoraUnsubscribe subscribe${l(e.functionName)}(`,` ${t}{LunoraDataCallback? onData, LunoraErrorCallback? onError}`,` ) => _client.subscribe(${a}, args: ${r}, onData: onData, onError: onError);`,"",` /// live ${p(e.summary)}, as a Stream — bind it with StreamBuilder.`,e.resultType===void 0?` Stream<Object?> watch${l(e.functionName)}(${n}) => ${i};`:[` Stream<${e.resultType}> watch${l(e.functionName)}(${n}) =>`,` ${i}.map((raw) => ${ye(e.resultType,"raw")});`].join(`
|
|
27
|
+
`)].join(`
|
|
28
|
+
`)},Ge=e=>{const n=`${l(e.name)}Api`,t=e.methods.map(r=>r.verb==="query"?`${Q(r)}
|
|
29
|
+
|
|
30
|
+
${He(r)}`:Q(r)).join(`
|
|
31
|
+
|
|
32
|
+
`);return[`/// Functions declared in \`${p(e.name)}\`.`,`class ${n} {`,` const ${n}(this._client);`,""," final LunoraClient _client;","",t,"}"].join(`
|
|
33
|
+
`)},Be=(e,n)=>{const t=r=>{if(r===void 0)return;const a=`${r.charAt(0).toLowerCase()}${r.slice(1)}FromJson`;if(!new RegExp(String.raw`^\S+ ${a}\(String str\) =>`,"mu").test(n))throw new Error(`sdk: the dart models declare "${r}" but no top-level decoder "${a}" — quicktype's Dart naming has changed; update objectResultsOnly in targets/dart.ts.`);return new RegExp(String.raw`^${r} ${a}\(String str\) => ${r}\.fromJson\(`,"mu").test(n)?r:void 0};return e.map(r=>({methods:r.methods.map(a=>({...a,resultType:t(a.resultType)})),name:r.name}))},Je=({models:e,namespaces:n})=>{T(n,"Dart",s=>[j(s.functionName)]);const t=Be(n,e),r=t.map(s=>` final ${l(s.name)}Api ${j(s.name)};`).join(`
|
|
34
|
+
`),a=t.map(s=>` ${j(s.name)} = ${l(s.name)}Api(client)`).join(`,
|
|
35
|
+
`),i=W(t).length>0?`import 'models.dart';
|
|
36
|
+
`:"";return{"lib/lunora_api.dart":[D,`/// The generated Lunora surface. Re-exports the vendored transport, so one
|
|
37
|
+
`,`/// import gives a consumer the client, the wire types and the models.
|
|
38
|
+
`,`library;
|
|
39
|
+
`,`
|
|
40
|
+
`,`export 'lunora.dart';
|
|
41
|
+
`,`export 'models.dart';
|
|
42
|
+
`,`
|
|
43
|
+
`,`import 'lunora.dart';
|
|
44
|
+
`,i,`
|
|
45
|
+
`,t.map(s=>Ge(s)).join(`
|
|
46
|
+
|
|
47
|
+
`),t.length>0?`
|
|
48
|
+
|
|
49
|
+
`:"","/// Typed entry point: `Api(client).<namespace>.<function>(args)`.\n",`class Api {
|
|
50
|
+
`,t.length>0?` Api(LunoraClient client)
|
|
51
|
+
: ${a.trimStart()};
|
|
52
|
+
|
|
53
|
+
${r}
|
|
54
|
+
`:` const Api(LunoraClient client);
|
|
55
|
+
`,`}
|
|
56
|
+
`].join(""),"lib/models.dart":e.length>0?`${D}${Ue(Pe(e))}
|
|
57
|
+
`:`${D}// No typed argument or result schemas in this deployment.
|
|
58
|
+
`,"pubspec.yaml":Me}},Ye={id:"dart",quicktype:{lang:"dart"},render:Je,requires:[],vendor:[{from:"lib",to:"lib"}]},P=`${f("go").map(e=>`// ${e}`).join(`
|
|
59
|
+
`)}
|
|
60
|
+
|
|
61
|
+
`,b="lunoraapi",N="lunorasdk",ze=`${N}/lunora`,Ze="1.22",F=e=>l(e),ee=(e,n)=>{const t=$(n,{none:"",typed:s=>`args ${s}, `,untyped:"args any, "}),r=$(n,{none:"nil",typed:()=>"args",untyped:"args"}),a=n.resultType??"any",i=`lunora.Verb${n.verb.charAt(0).toUpperCase()}${n.verb.slice(1)}`,o=`lunora.Call[${a}](a.client, ${i}, "${m(n.functionPath)}", ${r}, shardKey)`;return[`// ${F(n.functionName)} invokes ${p(n.summary)}.`,`func (a *${e}) ${F(n.functionName)}(${t}shardKey string) (${a}, error) {`,` return ${o}`,"}"].join(`
|
|
62
|
+
`)},Xe=(e,n)=>{const t=$(n,{none:"",typed:i=>`args ${i}, `,untyped:"args any, "}),r=$(n,{none:"nil",typed:()=>"args",untyped:"args"}),a=`Subscribe${F(n.functionName)}`;return[`// ${a} opens a live ${p(n.functionPath)}; it re-runs on every write to the tables it reads.`,`func (a *${e}) ${a}(${t}onData lunora.DataHandler, onError lunora.ErrorHandler, shardKey string) lunora.Unsubscribe {`,` return a.client.Subscribe("${m(n.functionPath)}", ${r}, onData, onError, shardKey)`,"}"].join(`
|
|
63
|
+
`)},Qe=e=>{const n=`${l(e.name)}API`,t=e.methods.map(r=>r.verb==="query"?`${ee(n,r)}
|
|
64
|
+
|
|
65
|
+
${Xe(n,r)}`:ee(n,r)).join(`
|
|
66
|
+
|
|
67
|
+
`);return[`// ${n} groups the functions declared in ${p(e.name)}.`,`type ${n} struct{ client *lunora.Client }`,"",t].join(`
|
|
68
|
+
`)},en=e=>{const n=new Map;for(const a of e.matchAll(/^type (\w+) (struct \{\n[\s\S]*?^\}|.*)$/gmu))n.set(a[1],a[2]);const t=new Set([...n].filter(([,a])=>a.startsWith(`struct {
|
|
69
|
+
`)&&!a.includes("`")).map(([a])=>a));let r=!0;for(;r;){r=!1;for(const[a,i]of n)!t.has(a)&&[...t].some(o=>new RegExp(String.raw`\b${o}\b`,"u").test(i))&&(t.add(a),r=!0)}return t},nn=({models:e,namespaces:n})=>{const t=en(e),r=c=>c!==void 0&&t.has(c)?void 0:c,a=n.map(c=>({methods:c.methods.map(u=>({...u,argsType:r(u.argsType),resultType:r(u.resultType)})),name:c.name})),i=a.map(c=>` ${l(c.name)} *${l(c.name)}API`).join(`
|
|
70
|
+
`),o=a.map(c=>` ${l(c.name)}: &${l(c.name)}API{client: client},`).join(`
|
|
71
|
+
`),s=[P,`package ${b}
|
|
72
|
+
`,`
|
|
73
|
+
`,`import "${ze}"
|
|
74
|
+
`,`
|
|
75
|
+
`,`// API is the typed entry point: api.<Namespace>.<Function>(args, shardKey).
|
|
76
|
+
`,`type API struct {
|
|
77
|
+
`,`${i}
|
|
78
|
+
`,`}
|
|
79
|
+
`,`
|
|
80
|
+
`,`// NewAPI binds the generated surface to a client.
|
|
81
|
+
`,`func NewAPI(client *lunora.Client) *API {
|
|
82
|
+
`,` return &API{
|
|
83
|
+
`,`${o}
|
|
84
|
+
`,` }
|
|
85
|
+
`,`}
|
|
86
|
+
`,`
|
|
87
|
+
`,a.map(c=>Qe(c)).join(`
|
|
88
|
+
|
|
89
|
+
`),`
|
|
90
|
+
`].join(""),d=e.length>0?`${P}package ${b}
|
|
91
|
+
|
|
92
|
+
${e}
|
|
93
|
+
`:`${P}package ${b}
|
|
94
|
+
|
|
95
|
+
// No typed argument or result schemas in this deployment.
|
|
96
|
+
`;return{[`${b}/api.go`]:s,[`${b}/models.go`]:d,"go.mod":[`// The generated Lunora Go SDK, with the transport vendored under ./lunora.
|
|
97
|
+
`,`//
|
|
98
|
+
`,`// A consuming module wires it in without a network fetch:
|
|
99
|
+
`,`//
|
|
100
|
+
`,`// require ${N} v0.0.0
|
|
101
|
+
`,`// replace ${N} => ./path/to/this/directory
|
|
102
|
+
`,`module ${N}
|
|
103
|
+
`,`
|
|
104
|
+
`,`go ${Ze}
|
|
105
|
+
`].join("")}},tn={id:"go",quicktype:{lang:"go",rendererOptions:{"just-types":"true",package:b}},render:nn,requires:[],vendor:[{from:"lunora",to:"lunora"}]},h="lunoraapi.models",q="lunoraapi/models",rn=24,an=new Set(["abstract","as","assert","boolean","break","byte","case","catch","char","class","const","continue","default","do","double","else","enum","extends","false","final","finally","float","for","fromWire","fun","goto","if","implements","import","in","instanceof","int","interface","is","long","native","new","null","object","package","private","protected","public","return","short","static","strictfp","super","switch","synchronized","this","throw","throws","toWire","transient","true","try","typealias","typeof","val","var","void","volatile","when","while","wireValue"]),sn=/[^A-Za-z0-9]+/gu,on=/([a-z0-9])([A-Z])/gu,ln=/^[A-Za-z]/u,cn=/^[A-Z]/u;class fe extends Error{}const y=e=>e!==null&&typeof e=="object"&&!Array.isArray(e)?e:void 0,un=e=>{const n=e.anyOf??e.oneOf;if(!Array.isArray(n)||n.length===0)return;const t=n.map(r=>y(r)?.const);if(t.every(r=>typeof r=="string"))return[...new Set(t)].toSorted((r,a)=>r.localeCompare(a))},ge=e=>{const n=e.anyOf??e.oneOf;if(!Array.isArray(n)||n.length!==2)return e;const t=n.filter(r=>y(r)?.type!=="null");return t.length===1?y(t[0])??e:e},pn=e=>{const n=l(e),t=n.charAt(0).toLowerCase()+n.slice(1),r=ln.test(t)?t:`value${n}`;return an.has(r)?`${r}_`:r},dn=e=>{const n=e.replaceAll(on,"$1_$2").replaceAll(sn,"_").toUpperCase().split("_").filter(t=>t.length>0).join("_");return cn.test(n)?n:`VALUE_${n}`},be=(e,n)=>{if(!n.has(e))return n.add(e),e;let t=2;for(;n.has(`${e}${String(t)}`);)t+=1;return n.add(`${e}${String(t)}`),`${e}${String(t)}`},ne=(e,n)=>{if(e.has(n.name))throw new fe(`sdk: two schemas both produce the JVM model "${n.name}"`);e.set(n.name,n)},$n=(e,n,t,r,a)=>{const i=new Set(Array.isArray(n)?n.filter(s=>typeof s=="string"):[]),o=new Set;return Object.entries(e).map(([s,d])=>{const c=y(d)??{},u=!i.has(s);return{name:be(pn(s),o),nullable:!u&&ge(c)!==c,optional:u,type:A(c,`${t}${l(s)}`,r+1,a),wireKey:s}})},A=(e,n,t,r)=>{if(t>=rn)return{kind:"unknown"};const a=un(e);if(a!==void 0){const c=new Set;return ne(r,{constants:a.map(u=>({name:be(dn(u),c),wireValue:u})),kind:"enum",name:n}),{kind:"enum",name:n}}const i=ge(e);if(i!==e)return A(i,n,t+1,r);const o=y(e.properties);if(o!==void 0)return ne(r,{fields:$n(o,e.required,n,t,r),kind:"class",name:n}),{kind:"class",name:n};const s=y(e.additionalProperties);if(s!==void 0)return{kind:"record",value:A(s,`${n}Value`,t+1,r)};const d=y(e.items);if(d!==void 0)return{item:A(d,`${n}Item`,t+1,r),kind:"list"};switch(e.type){case"boolean":return{kind:"boolean"};case"integer":case"number":return{kind:"number"};case"string":return{kind:"string"};default:return{kind:"unknown"}}},ve=e=>{const n=new Map;for(const t of pe(e)){if(y(t.schema.properties)===void 0)continue;const r=new Map;try{A(t.schema,t.name,0,r)}catch(a){if(a instanceof fe)continue;throw a}if(![...r.keys()].some(a=>n.has(a)))for(const[a,i]of r)n.set(a,i)}return[...n.values()].toSorted((t,r)=>t.name.localeCompare(r.name))},M=e=>[`// GENERATED by \`lunora sdk generate --lang ${e}\` — do not edit.`,"// Run the command again to regenerate."],L=e=>{switch(e.kind){case"boolean":return"Boolean";case"class":case"enum":return e.name;case"list":return`java.util.List<${L(e.item)}>`;case"number":return"Double";case"record":return`java.util.Map<String, ${L(e.value)}>`;case"string":return"String";default:return"Object"}},U=e=>{switch(e.kind){case"class":case"enum":return!0;case"list":return U(e.item);case"record":return U(e.value);default:return!1}},H=(e,n,t)=>{if(!U(e))return n;const r=`item${String(t)}`;switch(e.kind){case"class":return`${n} == null ? null : ${n}.toWire()`;case"enum":return`${n} == null ? null : ${n}.toValue()`;case"list":return`ModelWire.writeList(${n}, ${r} -> ${H(e.item,r,t+1)})`;case"record":return`ModelWire.writeRecord(${n}, ${r} -> ${H(e.value,r,t+1)})`;default:return n}},G=(e,n,t)=>{const r=`item${String(t)}`;switch(e.kind){case"boolean":return`ModelWire.flag(${n})`;case"class":return`ModelWire.readObject(${n}, ${e.name}::fromWire)`;case"enum":return`ModelWire.readEnum(${n}, ${e.name}::forValue)`;case"list":return`ModelWire.readList(${n}, ${r} -> ${G(e.item,r,t+1)})`;case"number":return`ModelWire.number(${n})`;case"record":return`ModelWire.readRecord(${n}, ${r} -> ${G(e.value,r,t+1)})`;case"string":return`ModelWire.text(${n})`;default:return n}},mn=e=>{const n=p(e.wireKey);return e.optional?[" /**",` * Wire key {@code ${n}} — OPTIONAL: null omits the key entirely, because`," * `v.optional` accepts the value or `undefined` and rejects an explicit null."," */"]:[` /** Wire key {@code ${n}}.${e.nullable?" Nullable: null is sent as an explicit null.":""} */`]},yn=100,fn=e=>{const n=e.fields.map(r=>`${L(r.type)} ${r.name}`),t=` public ${e.name}(${n.join(", ")}) {`;return t.length<=yn?[t]:[` public ${e.name}(`,...n.map((r,a)=>` ${r}${a===n.length-1?") {":","}`)]},gn=e=>{const n=e.fields.flatMap(r=>{const a=`wire.put("${m(r.wireKey)}", ${H(r.type,`this.${r.name}`,0)});`;return r.optional?[` if (this.${r.name} != null) {`,` ${a}`," }"]:[` ${a}`]}),t=e.fields.map(r=>` ${G(r.type,`wire.get("${m(r.wireKey)}")`,0)}`);return[...M("java"),"",`package ${h};`,"","/**",` * The \`${e.name}\` model.`," *"," * <p>Field names are local; the keys {@link #toWire()} and {@link #fromWire(Object)} use are"," * the schema's own, emitted verbatim, so a renamed field cannot reach the wire."," */",`public final class ${e.name} {`,...e.fields.flatMap(r=>[...mn(r),` public final ${L(r.type)} ${r.name};`,""]),...fn(e),...e.fields.map(r=>` this.${r.name} = ${r.name};`)," }",""," /** This model as the wire-shaped map the transport encodes. */"," public java.util.Map<String, Object> toWire() {"," java.util.Map<String, Object> wire = new java.util.LinkedHashMap<>();",...n,""," return wire;"," }",""," /** Rebuild from a decoded wire value. */",` public static ${e.name} fromWire(Object value) {`," java.util.Map<String, Object> wire = ModelWire.object(value);","",...t.length===0?[` return new ${e.name}();`]:[` return new ${e.name}(`,`${t.join(`,
|
|
106
|
+
`)});`]," }","}",""].join(`
|
|
107
|
+
`)},bn=e=>[...M("java"),"",`package ${h};`,"",`/** The \`${e.name}\` union. Each constant keeps the wire string it encodes to. */`,`public enum ${e.name} {`,...e.constants.map((n,t)=>` ${n.name}("${m(n.wireValue)}")${t===e.constants.length-1?";":","}`),""," private final String value;","",` ${e.name}(String value) {`," this.value = value;"," }",""," /** The wire string this constant encodes to. */"," public String toValue() {"," return this.value;"," }",""," /** The constant a wire string decodes to. */",` public static ${e.name} forValue(String value) {`,` for (${e.name} candidate : values()) {`," if (candidate.value.equals(value)) {"," return candidate;"," }"," }","",` throw new IllegalArgumentException("${e.name}: unknown wire value " + value);`," }","}",""].join(`
|
|
108
|
+
`),vn=[{lines:[' @SuppressWarnings("unchecked")'," static java.util.Map<String, Object> object(Object value) {"," return value instanceof java.util.Map"," ? (java.util.Map<String, Object>) value"," : new java.util.LinkedHashMap<String, Object>();"," }"],name:"object"},{lines:[" static String text(Object value) {"," return value instanceof String ? (String) value : null;"," }"],name:"text"},{lines:[" static Double number(Object value) {"," return value instanceof Number ? ((Number) value).doubleValue() : null;"," }"],name:"number"},{lines:[" static Boolean flag(Object value) {"," return value instanceof Boolean ? (Boolean) value : null;"," }"],name:"flag"},{lines:[" /** A nested model, or null when the payload carried no object there. */"," static <T> T readObject(Object value, java.util.function.Function<Object, T> read) {"," return value instanceof java.util.Map ? read.apply(value) : null;"," }"],name:"readObject"},{lines:[" /** An enum constant, or null when the payload carried no string there. */"," static <T> T readEnum(Object value, java.util.function.Function<String, T> read) {"," return value instanceof String ? read.apply((String) value) : null;"," }"],name:"readEnum"},{lines:[" static <T> java.util.List<T> readList("," Object value, java.util.function.Function<Object, T> read) {"," if (!(value instanceof java.util.List)) {"," return null;"," }",""," java.util.List<T> items = new java.util.ArrayList<T>();",""," for (Object item : (java.util.List<?>) value) {"," items.add(read.apply(item));"," }",""," return items;"," }"],name:"readList"},{lines:[" static <T> java.util.Map<String, T> readRecord("," Object value, java.util.function.Function<Object, T> read) {"," if (!(value instanceof java.util.Map)) {"," return null;"," }",""," java.util.Map<String, T> entries = new java.util.LinkedHashMap<String, T>();",""," for (java.util.Map.Entry<?, ?> entry : ((java.util.Map<?, ?>) value).entrySet()) {"," entries.put(String.valueOf(entry.getKey()), read.apply(entry.getValue()));"," }",""," return entries;"," }"],name:"readRecord"},{lines:[" static <T> java.util.List<Object> writeList("," java.util.List<T> items, java.util.function.Function<T, Object> write) {"," if (items == null) {"," return null;"," }",""," java.util.List<Object> encoded = new java.util.ArrayList<Object>(items.size());",""," for (T item : items) {"," encoded.add(write.apply(item));"," }",""," return encoded;"," }"],name:"writeList"},{lines:[" static <T> java.util.Map<String, Object> writeRecord("," java.util.Map<String, T> entries, java.util.function.Function<T, Object> write) {"," if (entries == null) {"," return null;"," }",""," java.util.Map<String, Object> encoded = new java.util.LinkedHashMap<String, Object>();",""," for (java.util.Map.Entry<String, T> entry : entries.entrySet()) {"," encoded.put(entry.getKey(), write.apply(entry.getValue()));"," }",""," return encoded;"," }"],name:"writeRecord"}],wn=e=>{const n=vn.filter(t=>e.includes(`ModelWire.${t.name}(`));return[...M("java"),"",`package ${h};`,"","/** Wire readers and writers shared by the generated models. */","final class ModelWire {"," private ModelWire() {}",...n.flatMap(t=>["",...t.lines]),"}",""].join(`
|
|
109
|
+
`)},hn=e=>{const n=ve(e);if(n.length===0)return{};const t={};for(const r of n)t[`${q}/${r.name}.java`]=r.kind==="enum"?bn(r):gn(r);return{[`${q}/ModelWire.java`]:wn(Object.values(t).join(`
|
|
110
|
+
`)),...t}},B=e=>{switch(e.kind){case"boolean":return"Boolean";case"class":case"enum":return e.name;case"list":return`List<${B(e.item)}>`;case"number":return"Double";case"record":return`Map<String, ${B(e.value)}>`;case"string":return"String";default:return"WireValue"}},S=(e,n,t)=>{const r=`item${String(t)}`,a=`entry${String(t)}`;switch(e.kind){case"boolean":return`WireValue.Bool(${n})`;case"class":return`${n}.toWire()`;case"enum":return`WireValue.Text(${n}.wireValue)`;case"list":return`WireValue.Arr(${n}.map { ${r} -> ${S(e.item,r,t+1)} })`;case"number":return`WireValue.Num(${n})`;case"record":return`WireValue.Obj(${n}.map { ${a} -> ${a}.key to ${S(e.value,`${a}.value`,t+1)} })`;case"string":return`WireValue.Text(${n})`;default:return n}},J=(e,n,t,r)=>`wireNeed(${we(e,n,t,r)}, "${w(r)}")`,we=(e,n,t,r)=>{const a=`item${String(t)}`,i=`entry${String(t)}`;switch(e.kind){case"boolean":return`wireBool(${n})`;case"class":return`wireObj(${n})?.let { ${a} -> ${e.name}.fromWire(${a}) }`;case"enum":return`wireText(${n})?.let { ${a} -> ${e.name}.forValue(${a}) }`;case"list":return`wireArr(${n})?.items?.map { ${a} -> ${J(e.item,a,t+1,`${r}[]`)} }`;case"number":return`wireNum(${n})`;case"record":return`wireObj(${n})?.fields?.associate { ${i} -> ${i}.first to ${J(e.value,`${i}.second`,t+1,`${r}{}`)} }`;case"string":return`wireText(${n})`;default:return n}},jn=e=>{const n=e.fields.map(a=>{const i=p(a.wireKey);return[...a.optional?[" /**",` * Wire key \`${i}\` — OPTIONAL: null omits the key entirely, because`," * `v.optional` accepts the value or `undefined` and rejects an explicit null."," */"]:[` /** Wire key \`${i}\`.${a.nullable?" Nullable: null is sent as an explicit null.":""} */`],` val ${a.name}: ${B(a.type)}${a.optional||a.nullable?"?":""}${a.optional?" = null":""},`]}),t=e.fields.map(a=>{const i=w(a.wireKey),o=`this@${e.name}.${a.name}`;return a.optional?` ${o}?.let { add("${i}" to ${S(a.type,"it",0)}) }`:a.nullable?` add("${i}" to (${o}?.let { ${S(a.type,"it",0)} } ?: WireValue.Null))`:` add("${i}" to ${S(a.type,o,0)})`}),r=e.fields.map(a=>{const i=`wireField(value, "${w(a.wireKey)}")`,o=a.optional||a.nullable?we(a.type,i,0,a.wireKey):J(a.type,i,0,a.wireKey);return` ${a.name} = ${o},`});return["/**",` * The \`${e.name}\` model.`," *"," * Property names are local; the keys [toWire] and [fromWire] use are the schema's own,"," * emitted verbatim, so a renamed property cannot reach the wire."," */",`class ${e.name}(`,...n.flat(),") {"," /** This model as the wire-shaped object the transport encodes. */"," fun toWire(): WireValue ="," WireValue.Obj("," buildList {",...t," },"," )",""," companion object {"," /** Rebuild from a decoded wire value. */",` fun fromWire(value: WireValue): ${e.name} =`,` ${e.name}(`,...r," )"," }","}"]},An=e=>[`/** The \`${e.name}\` union. Each entry keeps the wire string it encodes to. */`,`enum class ${e.name}(val wireValue: String) {`,...e.constants.map(n=>` ${n.name}("${w(n.wireValue)}"),`)," ;",""," companion object {"," /** The entry a wire string decodes to. */",` fun forValue(value: String): ${e.name} =`," entries.firstOrNull { it.wireValue == value }",` ?: throw IllegalArgumentException("${e.name}: unknown wire value " + value)`," }","}"],Sn=[{lines:["private fun wireField(value: WireValue, key: String): WireValue? ="," (value as? WireValue.Obj)?.fields?.firstOrNull { it.first == key }?.second"],name:"wireField"},{lines:["private fun wireText(value: WireValue?): String? = (value as? WireValue.Text)?.value"],name:"wireText"},{lines:["private fun wireNum(value: WireValue?): Double? = (value as? WireValue.Num)?.value"],name:"wireNum"},{lines:["private fun wireBool(value: WireValue?): Boolean? = (value as? WireValue.Bool)?.value"],name:"wireBool"},{lines:["private fun wireArr(value: WireValue?): WireValue.Arr? = value as? WireValue.Arr"],name:"wireArr"},{lines:["private fun wireObj(value: WireValue?): WireValue.Obj? = value as? WireValue.Obj"],name:"wireObj"},{lines:["/** A required field the payload omitted or mistyped is a contract violation, not a null. */","private fun <T> wireNeed(read: T?, label: String): T =",' read ?: throw WireFormatException("lunora: the wire payload is missing or mistyped " + label)'],name:"wireNeed"}],_n=e=>{const n=ve(e);if(n.length===0)return{};const t=n.flatMap(o=>[...o.kind==="enum"?An(o):jn(o),""]),r=Sn.filter(o=>t.some(s=>s.includes(`${o.name}(`))),a=r.flatMap((o,s)=>s===0?[...o.lines]:["",...o.lines]),i=[...M("kotlin"),"",`package ${h}`,"",...r.some(o=>o.name==="wireNeed")?["import dev.lunora.WireFormatException"]:[],"import dev.lunora.WireValue","",...t,...a,""].join(`
|
|
111
|
+
`);return{[`${q}/Models.kt`]:i}},Tn=`${f("java").map(e=>`// ${e}`).join(`
|
|
112
|
+
`)}
|
|
113
|
+
|
|
114
|
+
`,te="lunoraapi",En=new Set(["abstract","assert","boolean","break","byte","case","catch","char","class","const","continue","default","do","double","else","enum","extends","final","finally","float","for","goto","if","implements","import","instanceof","int","interface","long","native","new","package","private","protected","public","return","short","static","strictfp","super","switch","synchronized","this","throw","throws","transient","try","void","volatile","while"]),O=e=>{const n=l(e),t=n.charAt(0).toLowerCase()+n.slice(1);return En.has(t)?`${t}_`:t},kn=e=>`Client.Verb.${e.toUpperCase()}`,he=e=>e.argsType===void 0?{payload:"args",type:"java.util.Map<String, Object>"}:{payload:"args == null ? null : args.toWire()",type:e.argsType},re=e=>{const n=he(e),t=`client.call(
|
|
115
|
+
${kn(e.verb)}, "${m(e.functionPath)}", ${n.payload}, shardKey)`;return[` /** ${p(e.summary)} */`,` public ${e.resultType??"Object"} ${O(e.functionName)}(${n.type} args, String shardKey) {`,` return ${e.resultType===void 0?t:`${e.resultType}.fromWire(${t})`};`," }"].join(`
|
|
116
|
+
`)},Nn=e=>{const n=he(e);return[` /** live ${p(e.summary)} — re-runs on every write to the tables it reads. */`,` public Runnable subscribe${l(e.functionName)}(`,` ${n.type} args,`," java.util.function.Consumer<Object> onData,"," java.util.function.Consumer<Client.SubscriptionError> onError,"," String shardKey) {"," return client.subscribe(",` "${m(e.functionPath)}", ${n.payload}, onData, onError, shardKey);`," }"].join(`
|
|
117
|
+
`)},On=e=>{const n=`${l(e.name)}Api`,t=e.methods.map(r=>r.verb==="query"?`${re(r)}
|
|
118
|
+
|
|
119
|
+
${Nn(r)}`:re(r)).join(`
|
|
120
|
+
|
|
121
|
+
`);return[` /** Functions declared in \`${p(e.name)}\`. */`,` public static final class ${n} {`," private final Client client;","",` ${n}(Client client) {`," this.client = client;"," }","",t.replaceAll(/^ {4}/gmu," ")," }"].join(`
|
|
122
|
+
`)},Cn=({namespaces:e})=>{T(e,"Java",i=>[O(i.functionName)]);const n=e.map(i=>` public final ${l(i.name)}Api ${O(i.name)};`).join(`
|
|
123
|
+
`),t=e.map(i=>` this.${O(i.name)} = new ${l(i.name)}Api(client);`).join(`
|
|
124
|
+
`),r=W(e).map(i=>`import ${h}.${i};
|
|
125
|
+
`),a=[Tn,`package ${te};
|
|
126
|
+
`,`
|
|
127
|
+
`,`import dev.lunora.Client;
|
|
128
|
+
`,...r,`
|
|
129
|
+
`,"/** Typed entry point: `new Api(client).<namespace>.<function>(args, shardKey)`. */\n",`public final class Api {
|
|
130
|
+
`,n.length>0?`${n}
|
|
131
|
+
|
|
132
|
+
`:"",` public Api(Client client) {
|
|
133
|
+
`,t.length>0?`${t}
|
|
134
|
+
`:` // No functions in this deployment.
|
|
135
|
+
`,` }
|
|
136
|
+
`,`
|
|
137
|
+
`,e.map(i=>On(i)).join(`
|
|
138
|
+
|
|
139
|
+
`),`
|
|
140
|
+
}
|
|
141
|
+
`].join("");return{[`${te}/Api.java`]:a}},Ln={id:"java",render:Cn,renderModels:hn,requires:[],vendor:[{from:"src/dev/lunora",to:"dev/lunora"}]},Rn=`${f("kotlin").map(e=>`// ${e}`).join(`
|
|
142
|
+
`)}
|
|
143
|
+
|
|
144
|
+
`,ae="lunoraapi",Wn=new Set(["as","break","class","continue","do","else","false","for","fun","if","in","interface","is","null","object","package","return","super","this","throw","true","try","typealias","typeof","val","var","when","while"]),je=e=>{const n=l(e),t=n.charAt(0).toLowerCase()+n.slice(1);return Wn.has(t)?`\`${t}\``:t},Mn=e=>`Verb.${e.toUpperCase()}`,Ae=e=>e.argsType===void 0?{declaration:"args: WireValue? = null",payload:"args"}:{declaration:`args: ${e.argsType}`,payload:"args.toWire()"},ie=e=>{const n=Ae(e),t=`client.call(${Mn(e.verb)}, "${w(e.functionPath)}", ${n.payload}, shardKey)`;return[` /** ${p(e.summary)} */`,` fun ${je(e.functionName)}(${n.declaration}, shardKey: String? = null): ${e.resultType??"WireValue"} =`,` ${e.resultType===void 0?t:`${e.resultType}.fromWire(${t})`}`].join(`
|
|
145
|
+
`)},Dn=e=>{const n=Ae(e);return[` /** live ${p(e.summary)} — re-runs on every write to the tables it reads. */`,` fun subscribe${l(e.functionName)}(`,` ${n.declaration},`," onData: ((WireValue) -> Unit)?,"," onError: ((SubscriptionError) -> Unit)? = null,"," shardKey: String? = null,"," ): () -> Unit =",` client.subscribe("${w(e.functionPath)}", ${n.payload}, onData, onError, shardKey)`].join(`
|
|
146
|
+
`)},Pn=e=>{const n=`${l(e.name)}Api`,t=e.methods.map(r=>r.verb==="query"?`${ie(r)}
|
|
147
|
+
|
|
148
|
+
${Dn(r)}`:ie(r)).join(`
|
|
149
|
+
|
|
150
|
+
`);return[`/** Functions declared in \`${p(e.name)}\`. */`,`class ${n}(private val client: Client) {`,t,"}"].join(`
|
|
151
|
+
`)},Vn=({namespaces:e})=>{const n=e.map(i=>` val ${je(i.name)}: ${l(i.name)}Api = ${l(i.name)}Api(client)`).join(`
|
|
152
|
+
`),t=e.flatMap(i=>i.methods),r=[`import dev.lunora.Client
|
|
153
|
+
`,...t.some(i=>i.verb==="query")?[`import dev.lunora.SubscriptionError
|
|
154
|
+
`]:[],`import dev.lunora.Verb
|
|
155
|
+
`,...t.some(i=>i.argsType===void 0||i.resultType===void 0)?[`import dev.lunora.WireValue
|
|
156
|
+
`]:[],...W(e).map(i=>`import ${h}.${i}
|
|
157
|
+
`)],a=[Rn,`package ${ae}
|
|
158
|
+
`,`
|
|
159
|
+
`,...r,`
|
|
160
|
+
`,e.map(i=>Pn(i)).join(`
|
|
161
|
+
|
|
162
|
+
`),`
|
|
163
|
+
|
|
164
|
+
`,"/** Typed entry point: `Api(client).<namespace>.<function>(args)`. */\n",`class Api(client: Client) {
|
|
165
|
+
`,n.length>0?`${n}
|
|
166
|
+
`:` init { require(true) { client } }
|
|
167
|
+
`,`}
|
|
168
|
+
`].join("");return{[`${ae}/Api.kt`]:a}},Kn={id:"kotlin",render:Vn,renderModels:_n,requires:[],vendor:[{from:"src",to:"dev/lunora"}]},In=new Set(["and","as","assert","async","await","break","class","continue","def","del","elif","else","except","False","finally","for","from","global","if","import","in","is","lambda","None","nonlocal","not","or","pass","raise","return","True","try","while","with","yield"]),k=`"""${f("python").join(`
|
|
169
|
+
|
|
170
|
+
`)}
|
|
171
|
+
"""
|
|
172
|
+
|
|
173
|
+
`,V="lunora_api",_=e=>{const n=E(e);return In.has(n)?`${n}_`:n},Se=e=>$(e,{none:"{}",typed:()=>"args.to_dict()",untyped:"args"}),xn=(e,n,t,r)=>$(e,{none:n,typed:t,untyped:r}),se=e=>{const n=e.resultType??"Any",t=xn(e,"self",i=>`self, args: ${i}`,"self, args: Any"),r=Se(e),a=`await self._client.${e.verb}("${m(e.functionPath)}", ${r}, shard_key)`;return[` async def ${_(e.functionName)}(${t}, *, shard_key: Optional[str] = None) -> ${n}:`,` """${p(e.summary)}"""`,` ${e.resultType===void 0?`return ${a}`:`return ${e.resultType}.from_dict(${a})`}`].join(`
|
|
174
|
+
`)},Fn=e=>{const n=Se(e),t=["self",...$(e,{none:[],typed:r=>[`args: ${r}`],untyped:["args: Any"]}),"on_data: Callback","on_error: Optional[ErrorCallback] = None","*","shard_key: Optional[str] = None"];return[` def subscribe_${_(e.functionName)}(`,...t.map(r=>` ${r},`)," ) -> Unsubscribe:",` """live ${p(e.summary)} — re-runs on every write to the tables it reads."""`,` return self._client.subscribe("${m(e.functionPath)}", ${n}, on_data, on_error, shard_key)`].join(`
|
|
175
|
+
`)},qn=e=>{const n=e.methods.map(t=>t.verb==="query"?`${se(t)}
|
|
176
|
+
|
|
177
|
+
${Fn(t)}`:se(t)).join(`
|
|
178
|
+
|
|
179
|
+
`);return[`class ${l(e.name)}Api:`,` """Functions declared in \`${p(e.name)}\`."""`,""," def __init__(self, client: LunoraClient) -> None:"," self._client = client","",n].join(`
|
|
180
|
+
`)},Un=e=>e.replaceAll(/^([ \t]*)except:$/gmu,"$1except Exception:"),Hn=({models:e,namespaces:n})=>{T(n,"Python",u=>[_(u.functionName),`subscribe_${_(u.functionName)}`]);const t=W(n),r=t.length>0?`from .models import ${t.join(", ")}
|
|
181
|
+
`:"",i=x(n).some(u=>u.verb==="query")?"Callback, ErrorCallback, LunoraClient, Unsubscribe":"LunoraClient",o=x(n).some(u=>u.resultType===void 0),s=n.map(u=>` self.${_(u.name)} = ${l(u.name)}Api(client)`).join(`
|
|
182
|
+
`),d=[k,`from typing import ${o?"Any, Optional":"Optional"}
|
|
183
|
+
`,`
|
|
184
|
+
`,`from lunora.client import ${i}
|
|
185
|
+
`,r,`
|
|
186
|
+
|
|
187
|
+
`,n.map(u=>qn(u)).join(`
|
|
188
|
+
|
|
189
|
+
|
|
190
|
+
`),`
|
|
191
|
+
|
|
192
|
+
|
|
193
|
+
`,`class Api:
|
|
194
|
+
`,' """Typed entry point: `Api(client).<namespace>.<function>(args)`."""\n',`
|
|
195
|
+
`,` def __init__(self, client: LunoraClient) -> None:
|
|
196
|
+
`,s.length>0?`${s}
|
|
197
|
+
`:` pass
|
|
198
|
+
`].join(""),c=["Api",...n.map(u=>`${l(u.name)}Api`)];return{[`${V}/__init__.py`]:[k,`from .api import ${c.join(", ")}
|
|
199
|
+
`,`
|
|
200
|
+
`,`__all__ = [${c.map(u=>`"${u}"`).join(", ")}]
|
|
201
|
+
`].join(""),[`${V}/api.py`]:d,[`${V}/models.py`]:e.length>0?`${k}${Un(e)}
|
|
202
|
+
`:`${k}# No typed argument or result schemas in this deployment.
|
|
203
|
+
`}},Gn={id:"python",quicktype:{lang:"python",rendererOptions:{"python-version":"3.7"}},render:Hn,requires:[],vendor:[{from:"lunora",to:"lunora"}]},K=`${f("ruby").map(e=>`# ${e}`).join(`
|
|
204
|
+
`)}
|
|
205
|
+
|
|
206
|
+
`,Bn=new Set(["alias","and","begin","break","case","class","def","defined?","do","else","elsif","end","ensure","false","for","if","in","module","next","nil","not","or","redo","rescue","retry","return","self","super","then","true","undef","unless","until","when","while","yield"]),z=e=>m(e).replaceAll("#","\\#"),v=e=>{const n=E(e);return Bn.has(n)?`${n}_`:n},Jn=` # Delegates to the transport, which owns the projection and its tests — see
|
|
207
|
+
# \`Lunora.wire_args\`. The path list is generated per model because only the
|
|
208
|
+
# schema knows which nils may be dropped.
|
|
209
|
+
def self.wire_args(model, optional_paths = [])
|
|
210
|
+
Lunora.wire_args(model, optional_paths)
|
|
211
|
+
end
|
|
212
|
+
|
|
213
|
+
`,Yn=e=>`[${e.map(n=>`[${n.map(t=>`"${z(t)}"`).join(", ")}]`).join(", ")}]`,_e=e=>$(e,{none:"{}",typed:()=>`LunoraApi.wire_args(args, ${Yn(e.argsNullPaths.optional)})`,untyped:"args"}),oe=e=>{const n=e.argsType===void 0&&!e.takesArgs?"shard_key: nil":"args, shard_key: nil",t=_e(e),r=`@client.${e.verb}("${z(e.functionPath)}", ${t}, shard_key)`,a=e.resultType===void 0?r:`${e.resultType}.from_dynamic!(${r})`;return[` # ${p(e.summary)}`,` def ${v(e.functionName)}(${n})`,` ${a}`," end"].join(`
|
|
214
|
+
`)},zn=e=>{const n=e.argsType===void 0&&!e.takesArgs?"on_data, on_error = nil, shard_key: nil":"args, on_data, on_error = nil, shard_key: nil",t=_e(e);return[` # live ${p(e.summary)} — re-runs on every write to the tables it reads.`,` def subscribe_${v(e.functionName)}(${n})`,` @client.subscribe("${z(e.functionPath)}", ${t}, on_data, on_error, shard_key)`," end"].join(`
|
|
215
|
+
`)},Zn=e=>{const n=e.methods.map(t=>t.verb==="query"?`${oe(t)}
|
|
216
|
+
|
|
217
|
+
${zn(t)}`:oe(t)).join(`
|
|
218
|
+
|
|
219
|
+
`);return[` # Functions declared in \`${p(e.name)}\`.`,` class ${l(e.name)}Api`," def initialize(client)"," @client = client"," end","",n," end"].join(`
|
|
220
|
+
`)},Xn=/^class \w+ < Dry::Struct\n[\s\S]*?def self\.from_dynamic!\(d\)\n\s*d = Types::Hash\[d\]/u,Qn=(e,n)=>{const t=new Map;for(const s of n.matchAll(/^class (\w+)\b[^\n]*\n[\s\S]*?^end$/gmu))t.set(s[1],s[0]);const r=s=>Xn.test(s),a=new Set([...t].filter(([,s])=>s.includes("< Dry::Struct")&&!r(s)).map(([s])=>s));let i=!0;for(;i;){i=!1;for(const[s,d]of t)!a.has(s)&&[...a].some(c=>new RegExp(String.raw`\b${c}\b`,"u").test(d))&&(a.add(s),i=!0)}const o=s=>{const d=s===void 0?void 0:t.get(s);return d!==void 0&&r(d)&&!a.has(s)?s:void 0};return e.map(s=>({methods:s.methods.map(d=>({...d,argsType:o(d.argsType),resultType:o(d.resultType)})),name:s.name}))},et=({models:e,namespaces:n})=>{T(n,"Ruby",o=>[v(o.functionName),`subscribe_${v(o.functionName)}`]);const t=Qn(n,e),r=t.map(o=>`:${v(o.name)}`).join(", "),a=t.map(o=>` @${v(o.name)} = ${l(o.name)}Api.new(client)`).join(`
|
|
221
|
+
`);return{"api.rb":[`# frozen_string_literal: true
|
|
222
|
+
|
|
223
|
+
`,K,`require_relative "models"
|
|
224
|
+
`,`
|
|
225
|
+
`,`module LunoraApi
|
|
226
|
+
`,x(t).some(o=>o.argsType!==void 0)?Jn:"",t.map(o=>Zn(o)).join(`
|
|
227
|
+
|
|
228
|
+
`),`
|
|
229
|
+
|
|
230
|
+
`," # Typed entry point: `Api.new(client).<namespace>.<function>(args)`.\n",` class Api
|
|
231
|
+
`,r.length>0?` attr_reader ${r}
|
|
232
|
+
|
|
233
|
+
`:"",` def initialize(client)
|
|
234
|
+
`,a.length>0?`${a}
|
|
235
|
+
`:` @client = client
|
|
236
|
+
`,` end
|
|
237
|
+
`,` end
|
|
238
|
+
`,`end
|
|
239
|
+
`].join(""),"models.rb":e.length>0?`# frozen_string_literal: true
|
|
240
|
+
|
|
241
|
+
${K}${e}
|
|
242
|
+
`:`# frozen_string_literal: true
|
|
243
|
+
|
|
244
|
+
${K}# No typed argument or result schemas in this deployment.
|
|
245
|
+
`}},nt={id:"ruby",quicktype:{lang:"ruby",rendererOptions:{}},render:et,requires:["dry-struct + dry-types (gems, required by the generated models)"],vendor:[{from:"lib/lunora.rb",to:"lunora.rb"},{from:"lib/lunora",to:"lunora"}]},C=`${f("rust").map(e=>`// ${e}`).join(`
|
|
246
|
+
`)}
|
|
247
|
+
|
|
248
|
+
`,tt=`${C}pub mod api;
|
|
249
|
+
pub mod models;
|
|
250
|
+
`,rt=`# The generated Lunora Rust SDK, with the transport vendored under ./lunora.
|
|
251
|
+
#
|
|
252
|
+
# Add to a consuming crate:
|
|
253
|
+
#
|
|
254
|
+
# lunora-api = { path = "sdk/rust" }
|
|
255
|
+
|
|
256
|
+
[package]
|
|
257
|
+
name = "lunora-api"
|
|
258
|
+
version = "0.1.0"
|
|
259
|
+
edition = "2021"
|
|
260
|
+
publish = false
|
|
261
|
+
|
|
262
|
+
# Its own workspace root, so a consumer whose project IS a workspace does not
|
|
263
|
+
# adopt this directory as a member (which then fails to build on its own).
|
|
264
|
+
[workspace]
|
|
265
|
+
|
|
266
|
+
[dependencies]
|
|
267
|
+
lunora = { path = "lunora" }
|
|
268
|
+
serde = { version = "1", features = ["derive"] }
|
|
269
|
+
serde_json = "1"
|
|
270
|
+
`,at=new Set(["abstract","as","async","await","become","box","break","const","continue","crate","do","dyn","else","enum","extern","false","final","fn","for","if","impl","in","let","loop","macro","match","mod","move","mut","override","priv","pub","ref","return","self","static","struct","super","trait","true","try","type","typeof","unsafe","unsized","use","virtual","where","while","yield"]),it=new Set(["crate","self","Self","super"]),R=e=>{const n=E(e);return it.has(n)?`${n}_`:at.has(n)?`r#${n}`:n},st=e=>`Verb::${l(e)}`,Te=e=>e.length===0?"&[]":`&[${e.map(n=>`&["${n.map(t=>m(t)).join('", "')}"][..]`).join(", ")}]`,le=e=>{const n=$(e,{none:"&self, shard_key: Option<&str>",typed:a=>`&self, args: &${a}, shard_key: Option<&str>`,untyped:"&self, args: &WireValue, shard_key: Option<&str>"}),t=$(e,{none:"&WireValue::Object(Vec::new())",typed:()=>`&from_model_json(&serde_json::to_value(args).map_err(|error| ClientError::Transport(error.to_string()))?, ${Te(e.argsNullPaths.optional)})`,untyped:"args"}),r=`self.client.call(${st(e.verb)}, "${m(e.functionPath)}", ${t}, shard_key)`;return e.resultType===void 0?[` /// ${p(e.summary)}`,` pub fn ${R(e.functionName)}(${n}) -> Result<WireValue, ClientError> {`,` ${r}`," }"].join(`
|
|
271
|
+
`):[` /// ${p(e.summary)}`,` pub fn ${R(e.functionName)}(${n}) -> Result<${e.resultType}, ClientError> {`,` let raw = ${r}?;`," let json = encode_wire(&raw).map_err(ClientError::Wire)?;"," serde_json::from_value(json).map_err(|error| ClientError::Transport(error.to_string()))"," }"].join(`
|
|
272
|
+
`)},ot=e=>{const n=$(e,{none:"",typed:r=>`args: &${r}, `,untyped:"args: &WireValue, "}),t=$(e,{none:"WireValue::Object(Vec::new())",typed:()=>`from_model_json(&serde_json::to_value(args).map_err(|error| ClientError::Transport(error.to_string()))?, ${Te(e.argsNullPaths.optional)})`,untyped:"args.clone()"});return[` /// live ${p(e.summary)} — re-runs on every write to the tables it reads.`,` pub fn subscribe_${E(e.functionName)}(`," &mut self,",` ${n}on_data: DataHandler,`," on_error: ErrorHandler,"," shard_key: Option<&str>,"," ) -> Result<String, ClientError> {",` Ok(self.client.subscribe_on_shard("${m(e.functionPath)}", ${t}, on_data, on_error, shard_key))`," }"].join(`
|
|
273
|
+
`)},lt=e=>{const n=`${l(e.name)}Api`,t=e.methods.map(r=>r.verb==="query"?`${le(r)}
|
|
274
|
+
|
|
275
|
+
${ot(r)}`:le(r)).join(`
|
|
276
|
+
|
|
277
|
+
`);return[`/// Functions declared in \`${p(e.name)}\`.`,`pub struct ${n}<'client> {`," client: &'client mut Client,","}","",`impl<'client> ${n}<'client> {`,t,"}"].join(`
|
|
278
|
+
`)},ct=({models:e,namespaces:n})=>{T(n,"Rust",a=>[R(a.functionName),`subscribe_${E(a.functionName)}`]);const t=n.map(a=>[` /// Functions declared in \`${p(a.name)}\`.`,` pub fn ${R(a.name)}(&mut self) -> ${l(a.name)}Api<'_> {`,` ${l(a.name)}Api { client: self.client }`," }"].join(`
|
|
279
|
+
`)).join(`
|
|
280
|
+
|
|
281
|
+
`),r=[C,`#![allow(dead_code, unused_imports)]
|
|
282
|
+
`,`
|
|
283
|
+
`,`use lunora::client::{Client, ClientError, DataHandler, ErrorHandler, Verb};
|
|
284
|
+
`,`use lunora::wire::{encode_wire, from_model_json, WireValue};
|
|
285
|
+
`,`
|
|
286
|
+
`,`use crate::models::*;
|
|
287
|
+
`,`
|
|
288
|
+
`,n.map(a=>lt(a)).join(`
|
|
289
|
+
|
|
290
|
+
`),`
|
|
291
|
+
|
|
292
|
+
`,"/// Typed entry point: `Api::new(&client).<namespace>().<function>(args)`.\n",`pub struct Api<'client> {
|
|
293
|
+
`,` client: &'client mut Client,
|
|
294
|
+
`,`}
|
|
295
|
+
`,`
|
|
296
|
+
`,`impl<'client> Api<'client> {
|
|
297
|
+
`,` pub fn new(client: &'client mut Client) -> Self {
|
|
298
|
+
`,` Self { client }
|
|
299
|
+
`,` }
|
|
300
|
+
`,t.length>0?`
|
|
301
|
+
${t}
|
|
302
|
+
`:"",`}
|
|
303
|
+
`].join("");return{"Cargo.toml":rt,"src/api.rs":r,"src/lib.rs":tt,"src/models.rs":e.length>0?`${C}#![allow(dead_code)]
|
|
304
|
+
|
|
305
|
+
${e}
|
|
306
|
+
`:`${C}#![allow(dead_code)]
|
|
307
|
+
|
|
308
|
+
// No typed argument or result schemas in this deployment.
|
|
309
|
+
`}},ut={id:"rust",quicktype:{lang:"rust",rendererOptions:{"just-types":"true"}},render:ct,requires:["serde (derive) + serde_json — declared in the emitted Cargo.toml, fetched by cargo"],vendor:[{from:"Cargo.toml",to:"lunora/Cargo.toml"},{from:"src",to:"lunora/src"}]},I=`${f("swift").map(e=>`// ${e}`).join(`
|
|
310
|
+
`)}
|
|
311
|
+
|
|
312
|
+
`,ce="Sources/LunoraApi",pt=`// swift-tools-version:5.9
|
|
313
|
+
|
|
314
|
+
import PackageDescription
|
|
315
|
+
|
|
316
|
+
// The generated Lunora Swift SDK, with the transport vendored under
|
|
317
|
+
// Sources/Lunora. Add to a consuming package — where "swift" below is the NAME OF
|
|
318
|
+
// THE DIRECTORY THIS FILE IS IN, which is how SwiftPM identifies a local path
|
|
319
|
+
// dependency. It ignores the "name:" field for that, and a bare product name in a
|
|
320
|
+
// target's dependencies does not resolve at all, so the directory name is the one
|
|
321
|
+
// spelling that works:
|
|
322
|
+
//
|
|
323
|
+
// dependencies: [.package(path: "sdk/swift")],
|
|
324
|
+
// targets: [
|
|
325
|
+
// .target(
|
|
326
|
+
// name: "YourTarget",
|
|
327
|
+
// dependencies: [.product(name: "LunoraApi", package: "swift")]
|
|
328
|
+
// )
|
|
329
|
+
// ]
|
|
330
|
+
let package = Package(
|
|
331
|
+
name: "LunoraSdk",
|
|
332
|
+
platforms: [.macOS(.v12), .iOS(.v15)],
|
|
333
|
+
products: [
|
|
334
|
+
.library(name: "LunoraApi", targets: ["LunoraApi"]),
|
|
335
|
+
.library(name: "Lunora", targets: ["Lunora"]),
|
|
336
|
+
],
|
|
337
|
+
targets: [
|
|
338
|
+
.target(name: "Lunora"),
|
|
339
|
+
.target(name: "LunoraApi", dependencies: ["Lunora"]),
|
|
340
|
+
]
|
|
341
|
+
)
|
|
342
|
+
`,dt=new Set(["as","associatedtype","borrowing","break","case","catch","class","consuming","continue","default","defer","deinit","do","else","enum","extension","fallthrough","false","fileprivate","for","func","guard","if","import","in","init","inout","internal","is","let","nil","nonisolated","open","operator","precedencegroup","private","protocol","public","repeat","rethrows","return","self","static","struct","subscript","super","switch","throw","throws","true","try","typealias","var","where","while"]),Y=e=>{const n=l(e),t=n.charAt(0).toLowerCase()+n.slice(1);return dt.has(t)?`\`${t}\``:t},$t=e=>`[${e.map(n=>`["${n.map(t=>m(t)).join('", "')}"]`).join(", ")}]`,Ee=e=>$(e,{none:"nil",typed:()=>{const{nullable:n}=e.argsNullPaths;return n.length===0?"try LunoraClient.wireValue(args)":`try LunoraClient.wireValue(args, nullablePaths: ${$t(n)})`},untyped:"args"}),ue=e=>{const n=$(e,{none:"shardKey: String? = nil",typed:o=>`_ args: ${o}, shardKey: String? = nil`,untyped:"_ args: Any, shardKey: String? = nil"}),t=Ee(e),r=e.resultType??"Any",a=`try client.${e.verb}("${m(e.functionPath)}", args: ${t}, shardKey: shardKey)`,i=e.resultType===void 0?`return ${a}`:[`let raw = ${a}`," let data = Data(Wire.stableStringify(raw).utf8)",` return try JSONDecoder().decode(${e.resultType}.self, from: data)`].join(`
|
|
343
|
+
`);return[` /// ${p(e.summary)}`,` public func ${Y(e.functionName)}(${n}) throws -> ${r} {`,` ${i}`," }"].join(`
|
|
344
|
+
`)},mt=e=>{const n=$(e,{none:"",typed:r=>`_ args: ${r}, `,untyped:"_ args: Any, "}),t=Ee(e);return[` /// live ${p(e.summary)} — re-runs on every write to the tables it reads.`," @discardableResult",` public func subscribe${l(e.functionName)}(`,` ${n}onData: ((Any) -> Void)?,`," onError: ((LunoraSubscriptionError) -> Void)? = nil,"," shardKey: String? = nil"," ) throws -> LunoraUnsubscribe {",` client.subscribe("${m(e.functionPath)}", args: ${t}, onData: onData, onError: onError, shardKey: shardKey)`," }"].join(`
|
|
345
|
+
`)},yt=e=>{const n=`${l(e.name)}API`,t=e.methods.map(r=>r.verb==="query"?`${ue(r)}
|
|
346
|
+
|
|
347
|
+
${mt(r)}`:ue(r)).join(`
|
|
348
|
+
|
|
349
|
+
`);return[`/// Functions declared in \`${p(e.name)}\`.`,`public struct ${n} {`," let client: LunoraClient","",t,"}"].join(`
|
|
350
|
+
`)},ft=({models:e,namespaces:n})=>{const t=n.map(i=>` public let ${Y(i.name)}: ${l(i.name)}API`).join(`
|
|
351
|
+
`),r=n.map(i=>` ${Y(i.name)} = ${l(i.name)}API(client: client)`).join(`
|
|
352
|
+
`),a=[I,`import Foundation
|
|
353
|
+
`,`import Lunora
|
|
354
|
+
`,`
|
|
355
|
+
`,n.map(i=>yt(i)).join(`
|
|
356
|
+
|
|
357
|
+
`),`
|
|
358
|
+
|
|
359
|
+
`,"/// Typed entry point: `API(client:).<namespace>.<function>(args)`.\n",`public struct API {
|
|
360
|
+
`,t.length>0?`${t}
|
|
361
|
+
|
|
362
|
+
`:"",` public init(client: LunoraClient) {
|
|
363
|
+
`,r.length>0?`${r}
|
|
364
|
+
`:` _ = client
|
|
365
|
+
`,` }
|
|
366
|
+
`,`}
|
|
367
|
+
`].join("");return{"Package.swift":pt,[`${ce}/Api.swift`]:a,[`${ce}/Models.swift`]:e.length>0?`${I}${e}
|
|
368
|
+
`:`${I}import Foundation
|
|
369
|
+
|
|
370
|
+
// No typed argument or result schemas in this deployment.
|
|
371
|
+
`}},gt={id:"swift",quicktype:{lang:"swift",rendererOptions:{"access-level":"public",initializers:"false"}},render:ft,requires:[],vendor:[{from:"Sources/Lunora",to:"Sources/Lunora"}]},bt={dart:Ye,go:tn,java:Ln,kotlin:Kn,python:Gn,ruby:nt,rust:ut,swift:gt},wt=Object.keys(bt).toSorted((e,n)=>e.localeCompare(n)),ht=async(e,n)=>{const t=Ne(e);Oe(t);const r=n.renderModels?.(e),a=r===void 0?await We(e,n):Object.values(r).join(`
|
|
372
|
+
`),i=Ce(t,a);return{files:{...r,...n.render({models:a,namespaces:i})},undeclared:Re(t,a),unrepresentable:Le(e)}};export{wt as SDK_LANGUAGES,bt as SDK_TARGETS,ht as generateSdk,St as isTypedSchema};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import{existsSync as l}from"node:fs";import{join as m}from"node:path";import{SyntaxKind as c,Node as o}from"ts-morph";import{diagnosticAt as u}from"./CodegenDiagnosticError-BUXlG3P-.mjs";import{b as p}from"./module-specifiers-WF8iAydP.mjs";import{p as g}from"./parse-validator-C6fHL7OS.mjs";import{findObjectProperty as f}from"./listLunoraSourceFiles-CSlcBYlo.mjs";const d="shapes.ts",S=r=>{const t=r.getSymbol();if(!t)return r.getText()==="defineShape";for(const e of t.getDeclarations())if(o.isImportSpecifier(e))return p(e.getImportDeclaration().getModuleSpecifierValue())?e.getNameNode().getText()==="defineShape":!1;return!1},h=r=>{const t=r.getSymbol();if(!t)return!1;for(const e of t.getDeclarations()){if(!o.isNamespaceImport(e))continue;const i=e.getFirstAncestorByKind(c.ImportDeclaration);return i!==void 0&&p(i.getModuleSpecifierValue())}return!1},x=r=>{if(o.isIdentifier(r))return S(r);if(o.isPropertyAccessExpression(r)){const t=r.getExpression();return r.getName()==="defineShape"&&o.isIdentifier(t)&&h(t)}return!1},b=r=>{const[t]=r.getArguments();if(!t||!o.isObjectLiteralExpression(t))return;const e=f(t,"table");if(!e||!o.isPropertyAssignment(e))return;const i=e.getInitializer();return i&&o.isStringLiteral(i)?i.getLiteralValue():void 0},y=r=>{const[t]=r.getArguments();if(!t||!o.isObjectLiteralExpression(t))return{};const e=f(t,"args");if(!e||!o.isPropertyAssignment(e))return{};const i=e.getInitializer();return!i||!o.isObjectLiteralExpression(i)?{}:g(i)},N=r=>{const t=[];for(const e of r.getVariableDeclarations()){if(!e.isExported())continue;const i=e.getInitializer();if(i?.getKind()!==c.CallExpression)continue;const s=i,a=s.getExpression();if(!x(a))continue;const n=e.getNameNode();if(!o.isIdentifier(n))throw u(n,"defineShape exports must be plain named exports (no destructuring)");t.push({args:y(s),exportName:n.getText(),filePath:"shapes",table:b(s)})}return t},L=(r,t)=>{const e=m(t,d);if(!l(e))return[];const i=r.getSourceFile(e)??r.addSourceFileAtPath(e),s=N(i);return s.sort((a,n)=>a.exportName.localeCompare(n.exportName)),s};export{d as SHAPES_FILENAME,L as discoverShapes};
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import{LunoraError as E}from"@lunora/errors";import{SCHEMA_SNAPSHOT_VERSION as v,sortKeys as f,diffSchemaSnapshots as I,parseSnapshotJson as A}from"./SCHEMA_SNAPSHOT_VERSION-C0oHwiJZ.mjs";import{isHyperdriveGlobalTable as L}from"./isD1GlobalTable-udvHAAzD.mjs";const O=e=>{const t=e.shardMode;return t==="global"?`global:${L(e)?"hyperdrive":"d1"}`:t==="root"?t:`shardBy:${t.field}`},_=(e,t)=>{const n=JSON.stringify(e),s=JSON.stringify(t);return n===s?0:n<s?-1:1},l=e=>{const t=e.kind==="optional",n=t?e.inner:void 0,s=n??e,r={kind:t?n?.kind??"unknown":e.kind,nullable:s.column?.notNull===!1||e.column?.notNull===!1,optional:t,unique:s.column?.unique===!0||e.column?.unique===!0,...j[s.kind]?.(s)};return(s.hasRefinement===!0||e.hasRefinement===!0)&&(r.refined=!0),r},N=e=>{const t={};for(const[n,s]of Object.entries(e))t[n]=l(s);return f(t)},j={array:e=>e.inner?{of:l(e.inner)}:{},id:e=>e.tableName===void 0?{}:{ref:e.tableName},literal:e=>e.literalValue===void 0?{}:{literal:e.literalValue},object:e=>e.shape?{fields:N(e.shape)}:{},record:e=>({...e.keyType?{key:l(e.keyType)}:{},...e.valueType?{of:l(e.valueType)}:{}}),union:e=>e.members?{members:e.members.map(t=>l(t)).toSorted(_)}:{}},D=e=>{const t={};for(const[o,a]of Object.entries(e.shape))t[o]=l(a);const n={};for(const o of e.indexes)n[o.name]={fields:[...o.fields],unique:o.unique??!1};const s={};for(const o of e.relations)s[o.name]={field:o.field,kind:o.kind,table:o.table};const r={commitOrdered:e.commitOrdered===!0,fields:f(t),indexes:f(n),memory:e.memory===!0,relations:f(s),shardMode:O(e)};return e.ttl&&(r.ttl=e.ttl.after===void 0?{field:e.ttl.field}:{after:e.ttl.after,field:e.ttl.field}),r},C=(e,t)=>{const n={};for(const r of e.tables)n[r.name]=D(r);const s=[...t].sort();return{jurisdiction:e.jurisdiction,migrationIds:s,tables:f(n),version:v}};class R extends E{constructor(t){super("SCHEMA_SNAPSHOT_PARSE",t,{name:"SchemaSnapshotParseError"})}}const J=e=>{const t=A(e);if(t.status==="invalid")throw new R(t.error);return t.status==="ok"?t.snapshot:void 0},M={build:{allowDrift:!0,updateBaseline:!1},deploy:{allowDrift:!0,updateBaseline:!0},prepare:{allowDrift:!0,updateBaseline:!0},verify:{allowDrift:!0,updateBaseline:!1}},y=" • For backward-compatible changes (e.g. adding an optional field): pass `--allow-schema-drift` to skip the block.",k=" • To accept the new shape without a migration (you know data is compatible): pass `--update-schema-baseline`.",B=e=>{const t=e===void 0?void 0:M[e];if(e===void 0||t===void 0)return`${y}
|
|
2
|
+
${k}
|
|
3
|
+
`;const n=t.updateBaseline?k:` • To accept the new shape without a migration, run \`lunora prepare --update-schema-baseline\` — \`lunora ${e}\` does not take that flag.`;return`${y}
|
|
4
|
+
${n}
|
|
5
|
+
`},p=e=>e.map(t=>` - ${t.summary}`).join(`
|
|
6
|
+
`),w=e=>e.remediation==="backfill"&&e.table!==void 0,x=/^[A-Za-z_]\w*$/u,F=e=>` lunora migrate create backfill_${e} --table ${e}`,P=(e,t,n)=>{const s=[...new Set(e.filter(o=>w(o)).map(o=>o.table))],r=[];if(s.length>0){r.push(" • Add a `defineMigration({ id, table, up })` in lunora/ for each affected table, then re-run this command — the baseline is re-blessed on a successful deploy, not by `lunora migrate` itself.\n");const o=s.filter(a=>x.test(a));o.length>0&&r.push(`
|
|
7
|
+
Scaffold the missing migration(s) — the generated \`up\` is an identity placeholder you must fill in:
|
|
8
|
+
${o.map(a=>F(a)).join(`
|
|
9
|
+
`)}
|
|
10
|
+
|
|
11
|
+
`)}return t.length>0&&r.push(` • Migration(s) ${t.join(", ")} declare a non-literal \`table\`, so codegen cannot tell which table they visit and they cover nothing. Use a string literal.
|
|
12
|
+
`),r.push(B(n)),[`${n??"deploy"} blocked: ${String(e.length)} unresolved breaking schema change(s) since the last blessed schema baseline:`,p(e),"",`To fix:
|
|
13
|
+
${r.join("")}Docs: https://lunora.dev/docs/migrations`].join(`
|
|
14
|
+
`)},V=e=>{const{allowDrift:t=!1,baseline:n,command:s,current:r,migrations:o}=e,a=I(n,r),u=a.changes.filter(i=>i.severity==="breaking"),b=r.migrationIds.filter(i=>!(n?.migrationIds??[]).includes(i)),m=o.filter(i=>b.includes(i.id)),c=(i,h)=>({blocked:i,changes:a.changes,newMigrationIds:b,reason:h}),T=new Set(m.filter(i=>i.table!=="").map(i=>i.table)),$=m.filter(i=>i.table==="").map(i=>i.id);if(a.changes.length===0||n===void 0)return c(!1,"");if(u.length===0)return c(!1,`schema drift detected (all additive/safe):
|
|
15
|
+
${p(a.changes)}`);const g=u.filter(i=>!w(i)||!T.has(i.table));if(g.length===0){const i=new Set(u.map(d=>d.table)),h=m.filter(d=>i.has(d.table)).map(d=>d.id);return c(!1,`breaking schema drift detected, covered by ${String(h.length)} new migration(s) (${h.join(", ")}):
|
|
16
|
+
${p(u)}`)}const S=P(g,$,s);return t?c(!1,`${S}
|
|
17
|
+
|
|
18
|
+
(overridden by --allow-schema-drift)`):c(!0,S)};export{R as SchemaSnapshotParseError,C as buildSchemaSnapshot,V as evaluateSchemaDrift,J as parseSchemaSnapshot};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import{existsSync as y}from"node:fs";import{join as b}from"node:path";import{LunoraError as w}from"@lunora/errors";import{isValidCronExpression as k}from"@lunora/scheduler";import{workflowDefaultName as E,workflowClassName as S}from"@lunora/workflow";import{Node as n,VariableDeclarationKind as v,SyntaxKind as P}from"ts-morph";import{diagnosticAt as c}from"./CodegenDiagnosticError-BUXlG3P-.mjs";import{unwrapToCallExpression as x,findObjectProperty as d,stringPropertyFor as L}from"./listLunoraSourceFiles-CSlcBYlo.mjs";const $="workflows.ts",A=new Set(["do","sleep","sleepUntil","waitForEvent"]),N=o=>{const e=o.getSymbol();if(!e)return o.getText()==="defineWorkflow";for(const t of e.getDeclarations())if(n.isImportSpecifier(t))return t.getImportDeclaration().getModuleSpecifierValue()!=="@lunora/workflow"?!1:t.getNameNode().getText()==="defineWorkflow";return!1},m=L("workflow"),C=(o,e,t)=>{if(n.isNumericLiteral(o))return o.getLiteralValue();throw c(o,`workflow "${e}": \`${t}\` must be a static number literal — it is deploy configuration codegen writes into wrangler.jsonc`)},f=(o,e)=>{const t=d(o,e);return t&&n.isPropertyAssignment(t)?t.getInitializerOrThrow():void 0},g=(o,e,t)=>{if(n.isObjectLiteralExpression(o))return o;throw c(o,`workflow "${e}": \`${t}\` must be an inline object literal — it is deploy configuration codegen writes into wrangler.jsonc`)},D=(o,e)=>{if(!n.isArrayLiteralExpression(o)||o.getElements().length===0)throw c(o,`workflow "${e}": \`schedules\` must be a non-empty inline array of cron expression string literals`);return o.getElements().map(t=>{const r=m(t,e,"schedules[]");if(!k(r))throw c(t,`workflow "${e}": schedule "${r}" is not a valid cron expression`);return r})},W=(o,e)=>{const t={},r=f(o,"schedules");r!==void 0&&(t.schedules=D(r,e));const s=f(o,"limits");if(s!==void 0){const a=f(g(s,e,"limits"),"steps");if(a===void 0)t.limits={};else{const l=C(a,e,"limits.steps");if(!Number.isInteger(l)||l<=0)throw c(a,`workflow "${e}": \`limits.steps\` must be a positive integer (got ${String(l)})`);t.limits={steps:l}}}const i=f(o,"defaultRetention");if(i!==void 0){const a=g(i,e,"defaultRetention"),l={};for(const u of["errorRetention","successRetention"]){const p=f(a,u);p!==void 0&&(l[u]=m(p,e,`defaultRetention.${u}`))}t.defaultRetention=l}return t},I=o=>{const e=o.getExpression();if(!n.isPropertyAccessExpression(e)||!A.has(e.getName()))return!1;const t=e.getExpression();return n.isPropertyAccessExpression(t)&&t.getName()==="step"?!0:n.isIdentifier(t)&&t.getText()==="step"},O=o=>{const e=d(o,"handler");if(!e)return[];const t=n.isPropertyAssignment(e)?e.getInitializer():e;if(!t)return[];const r=[];for(const s of t.getDescendantsOfKind(P.CallExpression)){if(!I(s))continue;const i=s.getArguments()[0];!i||!(n.isStringLiteral(i)||n.isNoSubstitutionTemplateLiteral(i))||r.push({line:s.getStartLineNumber(),method:s.getExpression().getName(),name:i.getLiteralValue()})}return r},h=o=>{let e=o;for(;e&&(n.isAsExpression(e)||n.isSatisfiesExpression(e)||n.isParenthesizedExpression(e));)e=e.getExpression();return e},F=o=>{const e=h(o);if(e&&n.isObjectLiteralExpression(e))return e;if(!(!e||!n.isIdentifier(e)))for(const t of e.getSymbol()?.getDeclarations()??[]){const s=n.isVariableDeclaration(t)&&t.getVariableStatement()?.getDeclarationKind()===v.Const?h(t.getInitializer()):void 0;if(s&&n.isObjectLiteralExpression(s))return s}},T=(o,e)=>{const t=F(o.getArguments()[0]);if(!t)throw c(o,`workflow "${e}": defineWorkflow's argument must be an object literal, or a local \`const\` holding one — codegen reads \`name\` and the \`ctx.step.*\` calls out of it statically. Keep the handler wherever you like and pass it through: \`const config = { handler: myHandler }; export const ${e} = defineWorkflow(config);\`.`);const r={className:S(e),exportName:e,name:E(e),steps:O(t)},s=d(t,"name");return s&&n.isPropertyAssignment(s)&&(r.name=m(s.getInitializerOrThrow(),e,"name")),{...r,...W(t,e)}},j=o=>{const e=[];for(const t of o.getVariableDeclarations()){if(!t.isExported())continue;const r=x(t.getInitializer());if(!r)continue;const s=r.getExpression();if(!n.isIdentifier(s)||!N(s))continue;const i=t.getNameNode();if(!n.isIdentifier(i))throw c(i,"defineWorkflow exports must be plain named exports (no destructuring)");e.push(T(r,i.getText()))}return e},R=o=>{const e=new Map,t=new Map;for(const r of o){const s=e.get(r.name);if(s!==void 0)throw new w("DUPLICATE_WORKFLOW_NAME",`Duplicate workflow name "${r.name}": produced by both "${s}" and "${r.exportName}". Deployed workflow names must be unique across the project.`,{status:500});e.set(r.name,r.exportName);const i=t.get(r.className);if(i!==void 0)throw new w("DUPLICATE_WORKFLOW_CLASS",`Duplicate workflow class "${r.className}": produced by both "${i}" and "${r.exportName}". Workflow export names must yield unique generated class names.`,{status:500});t.set(r.className,r.exportName)}},B=(o,e)=>{const t=b(e,$);if(!y(t))return[];const r=o.getSourceFile(t)??o.addSourceFileAtPath(t),s=j(r);return s.sort((i,a)=>i.exportName.localeCompare(a.exportName)),R(s),s};export{$ as WORKFLOWS_FILENAME,B as discoverWorkflows};
|
|
@@ -0,0 +1,3 @@
|
|
|
1
|
+
import{m as b}from"./modules-DyCocr1e.mjs";import{r as E}from"./json-data-Chfs2Cz5.mjs";import{s as l}from"./paths-C-9fwEgQ.mjs";import{LUNORA_ERROR_CODES as P,objectSchema as g,validatorIrToJsonSchema as m}from"./LUNORA_ERROR_CODES-C2s0xWQD.mjs";import{G as A}from"./shared-DjUziztz.mjs";const T="/_lunora/rest",x=["authorization","cf-access-jwt-assertion","cookie","payment-signature","x-payment"],v=["x-d1-bookmark","x-lunora-shard-key"],j=e=>[...x,...(e.credentialHeaders??[]).map(t=>t.toLowerCase())],O=e=>Number.isFinite(e)?Math.max(0,Math.floor(e)):0,$=(...e)=>{const t=[];for(const r of e)for(const n of r?.split(",")??[]){const s=n.trim().toLowerCase();s!==""&&!t.includes(s)&&t.push(s)}return t.length===0?void 0:t.join(", ")},k=(e,t)=>{const r=[t,`max-age=${String(O(e.maxAge))}`];return e.staleWhileRevalidate!==void 0&&r.push(`stale-while-revalidate=${String(O(e.staleWhileRevalidate))}`),r.join(", ")},N=e=>e.scope==="public"?$(e.vary,...j(e),...v):$(e.vary,...v),q=e=>{const t=e.indexOf(":");if(!(t<=0||t>=e.length-1||e.indexOf(":",t+1)!==-1))return{name:e.slice(t+1),namespace:e.slice(0,t)}},_=e=>{const t=q(e);if(t!==void 0)return`${T}/${t.namespace}/${t.name}`},C=e=>e==="query"?"GET":"POST",y="#/components/responses/LunoraError",R=/:([A-Za-z_$][\w$]*)/gu,w=e=>[...e.matchAll(R)].map(t=>t[1]),D=e=>e.replaceAll(R,"{$1}"),f=e=>e.kind==="optional"?e.inner??e:e,I=e=>{const t=new Set(w(e.path)),r=[];for(const[n,s]of Object.entries(e.searchParams)){const c=f(s);r.push({description:`Query parameter \`${n}\``,in:"query",name:n,required:s.kind!=="optional",schema:m(c)})}for(const[n,s]of Object.entries(e.params)){const c=f(s);r.push({description:`Path parameter \`${n}\``,in:t.has(n)?"path":"query",name:n,required:t.has(n)?!0:s.kind!=="optional",schema:m(c)})}return r},S=e=>e?{content:{"application/json":{schema:m(e)}},description:"Successful response."}:{content:{"application/json":{schema:{description:"Return shape is TS-inferred (no `.output()` declared); best-effort — any JSON."}}},description:"Successful response. The return shape is TypeScript-inferred and not declared via `.output()`, so it is documented best-effort."},L=(e,t)=>{const r=I(e),n={description:`${e.stream?"Streaming (SSE) ":""}HTTP route handler \`${e.exportName}\` (${e.method} ${e.path}).`,operationId:`${e.method.toLowerCase()}_${l(e.path)}`,responses:{200:S(e.output),204:{description:"No content (handler returned `undefined`)."},default:{$ref:y}},summary:`${e.method} ${e.path}`,tags:[t]};return r.length>0&&(n.parameters=r),Object.keys(e.body).length>0&&(n.requestBody={content:{"application/json":{schema:g(e.body)}},required:!0}),e.stream&&(n["x-lunora-stream"]="text/event-stream"),n},F=(e,t)=>{const r=`${l(e.filePath)}:${e.exportName}`,n={additionalProperties:!1,properties:{args:g(e.args),functionPath:{const:r,type:"string"},shardKey:{description:"Optional shard key; omitted routes to the default shard.",type:"string"}},required:["functionPath"],type:"object"};return{operation:{description:`Invoke the \`${e.kind}\` \`${r}\` over the Lunora RPC envelope (POST /_lunora/rpc).`,operationId:r,requestBody:{content:{"application/json":{schema:n}},required:!0},responses:{200:S(e.output),default:{$ref:y}},summary:`${e.kind}: ${r}`,tags:[t],"x-lunora-function-kind":e.kind},pathKey:`/_lunora/rpc#${r}`}},H=(e,t)=>{if(e===void 0||t!=="get"||e.scope===void 0||e.maxAge===void 0)return{};const r={maxAge:e.maxAge,scope:e.scope,...e.staleWhileRevalidate===void 0?{}:{staleWhileRevalidate:e.staleWhileRevalidate},...e.tag===void 0?{}:{tag:e.tag},...e.vary===void 0?{}:{vary:e.vary}},n={"Cache-Control":{description:r.scope==="public"?"Caching policy. `public` applies only to an uncredentialed request — a request carrying `Authorization` or `Cookie` is always answered `private`.":"Caching policy. Restricted to the caller's own cache; never stored by a shared/edge cache.",schema:{example:k(r,r.scope),type:"string"}}};r.tag!==void 0&&(n["Cache-Tag"]={description:"Purge tag for `ctx.cache.purge({ tags: [...] })`.",schema:{example:r.tag,type:"string"}});const s=N(r);return s!==void 0&&(n.Vary={description:"Request headers this response varies by. The endpoint's own negotiated headers are merged in at runtime.",schema:{example:s,type:"string"}}),{headers:n}},M=(e,t)=>{const r=`${l(e.filePath)}:${e.exportName}`,n=_(r);if(n===void 0)return;const s=C(e.kind),c=s==="GET",i={description:`Public REST endpoint for the \`${e.kind}\` \`${r}\` (opt-in via \`.expose({ rest: true })\`). Routed through the procedure, so auth / RLS / validators are enforced.`,operationId:`rest_${l(n)}`,responses:{200:{content:{"application/json":{schema:{description:"Procedure result. The shape is TS-inferred from the return type; best-effort — any JSON."}}},description:"Successful result (TypeScript-inferred return shape, documented best-effort).",...H(e.expose?.cache,c?"get":"post")},default:{$ref:y}},summary:`${s} ${n}`,tags:[t],"x-lunora-function-kind":e.kind};if(c){const d=Object.entries(e.args).map(([u,h])=>{const o=f(h);return{description:`Argument \`${u}\` (JSON-encoded for non-string values).`,in:"query",name:u,required:h.kind!=="optional",schema:m(o)}});return d.length>0&&(i.parameters=d),{method:"get",operation:i,path:n}}return i.requestBody={content:{"application/json":{schema:g(e.args)}},required:Object.keys(e.args).length>0},{method:"post",operation:i,path:n}},J=e=>{const t=e.version??"0.0.0",r=Object.create(null),n=o=>r[o]??Object.create(null),s=new Set,c=e.modules??[],i=o=>b(c,o);for(const o of e.httpRoutes){const a=D(o.path),p=n(a);p[o.method.toLowerCase()]=L(o,i(o.filePath)),r[a]=p,s.add(i(o.filePath))}const d=e.functions.filter(o=>o.visibility!=="internal"&&o.kind!=="stream");for(const o of d){const{operation:a,pathKey:p}=F(o,i(o.filePath));r[p]={post:a},s.add(i(o.filePath))}for(const o of d){if(o.expose?.rest!==!0)continue;const a=M(o,i(o.filePath));if(a===void 0)continue;const p=n(a.path);p[a.method]=a.operation,r[a.path]=p}const u=[...s].toSorted((o,a)=>o.localeCompare(a)).map(o=>({description:c.find(p=>p.name===o)?.description??`Operations declared in \`lunora/${o}\`.`,name:o}));return{components:{responses:{LunoraError:{content:{"application/json":{schema:{additionalProperties:!1,description:"Standard Lunora error envelope.",properties:{error:{additionalProperties:!1,properties:{code:{description:"Machine-readable error code. Clients switch on this value.",enum:P,type:"string"},message:{description:"Human-readable error message (never echoes internal details).",type:"string"}},required:["code","message"],type:"object"}},required:["error"],type:"object"}}},description:"A Lunora error response. The HTTP status reflects the error code (e.g. BAD_REQUEST→400, UNAUTHORIZED→401, FORBIDDEN→403, NOT_FOUND→404)."}}},info:{description:"Auto-generated from @lunora/values-typed functions by @lunora/codegen. Do not edit — run `lunora codegen` to regenerate.",title:"Lunora API",version:t},openapi:"3.1.0",paths:Object.fromEntries(Object.entries(r).map(([o,a])=>[o,{...a}])),tags:u}},z=e=>`${JSON.stringify(J(e),void 0,2)}
|
|
2
|
+
`,K=e=>`${A}export const openApiSpec = ${E(e,"Record<string, unknown>")};
|
|
3
|
+
`;export{J as buildOpenApiDocument,z as emitOpenApi,K as emitOpenApiModule};
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
const n=[{contextProperty:"access",key:"access",moduleSpecifier:"@lunora/cloudflare-access",requiredPackage:"@lunora/cloudflare-access",serverCtxField:`
|
|
2
|
+
/** Verified Cloudflare Access identity — a synchronous facade over the resolved claims (email / groups / hasGroup / claims). Anonymous when no Access token is present. */
|
|
3
|
+
readonly access: import("@lunora/cloudflare-access/context").AccessFacade;`,shardBinding:"bespoke",tier:"every"},{appMethod:{configKey:"ai",doc:"Override the Workers AI binding backing `ctx.ai` (defaults to `env.AI`).",method:"ai"},contextProperty:"ai",key:"ai",moduleSpecifier:"@lunora/ai",requiredPackage:"@lunora/ai",shardBinding:"bespoke",tier:"action"},{appMethod:{configKey:"aiSearch",doc:"Override the AI Search namespace binding backing `ctx.aiSearch` (defaults to `env.AI_SEARCH`).",method:"aiSearch"},contextProperty:"aiSearch",key:"aiSearch",moduleSpecifier:"@lunora/bindings/ai-search",requiredPackage:"@lunora/bindings",serverCtxField:'\n /** Cloudflare AI Search namespace (`ai_search_namespaces`): `.get(name)` an instance, then `search` / `chatCompletions`. Billed, non-deterministic network I/O — available only in actions. */\n readonly aiSearch: import("@lunora/bindings/ai-search").AiSearch;',shardBinding:{binding:{envName:"AI_SEARCH"},clientType:"AiSearch",missingMessage:"ctx.aiSearch: no AI Search binding found. Add an \\`ai_search_namespaces\\` binding (env.AI_SEARCH) to wrangler.jsonc, or point \\`defineApp().aiSearch((env) => …)\\` at yours.",stubMethods:["chatCompletions","create","delete","get","list","search"],syncStubMethods:["get"]},tier:"action"},{appMethod:{configKey:"analytics",doc:"Override the Analytics Engine dataset backing `ctx.analytics` (defaults to `env.ANALYTICS`).",method:"analytics"},contextProperty:"analytics",key:"analytics",moduleSpecifier:"@lunora/bindings/analytics",requiredPackage:"@lunora/bindings",serverCtxField:`
|
|
4
|
+
/** Analytics Engine telemetry sink. Fire-and-forget and sampled; do not read it back in-handler. */
|
|
5
|
+
readonly analytics: import("@lunora/bindings/analytics").AnalyticsClient;`,shardBinding:{binding:{bindingType:"AnalyticsEngineDatasetLike",envName:"ANALYTICS",factory:{name:"createAnalytics"}},clientType:"AnalyticsClient",missingMessage:"ctx.analytics: no Analytics Engine binding found. Add an \\`analytics_engine_datasets\\` binding (env.ANALYTICS) to wrangler.jsonc, or pass \\`analytics\\` to createShardDO().",stubMethods:["track","writeDataPoint"],syncStubMethods:["track","writeDataPoint"]},tier:"every"},{appMethod:{configKey:"artifacts",doc:"Override the Artifacts binding backing `ctx.artifacts` (defaults to `env.ARTIFACTS`).",method:"artifacts"},contextProperty:"artifacts",key:"artifacts",moduleSpecifier:"@lunora/bindings/artifacts",requiredPackage:"@lunora/bindings",serverCtxField:'\n /** Cloudflare Artifacts repos (create/import/fork, Git tokens, read commits and files). Non-deterministic — available only in actions. Writes go through `git push` with a token, not this client. */\n readonly artifacts: import("@lunora/bindings/artifacts").ArtifactsClient;',shardBinding:{binding:{bindingType:"ArtifactsBindingLike",envName:"ARTIFACTS",factory:{name:"createArtifacts",option:"binding"}},clientType:"ArtifactsClient",missingMessage:'ctx.artifacts: no Artifacts binding found. Add an \\`artifacts\\` binding ({ binding: \\"ARTIFACTS\\", namespace }) to wrangler.jsonc, or point ctx.artifacts at another binding with defineApp().artifacts((env) => env.<BINDING>).',stubMethods:["authenticatedRemote","create","delete","import","info","list","withRepo"],syncStubMethods:["authenticatedRemote"]},tier:"action"},{appMethod:{configKey:"browser",doc:"Build the `ctx.browser` helper, e.g. `(env) => createBrowser({ binding: env.BROWSER, launch })`. REQUIRED: unlike the binding-backed capabilities, `ctx.browser` is not auto-constructed — without this thunk every method throws, because the generated worker deliberately stays free of the optional `@cloudflare/playwright` peer.",method:"browser"},contextProperty:"browser",key:"browser",moduleSpecifier:"@lunora/browser",requiredPackage:"@lunora/browser",serverCtxField:`
|
|
6
|
+
/** Browser Rendering (screenshots/PDF/scrape). Non-deterministic — available only in actions. */
|
|
7
|
+
readonly browser: import("@lunora/browser").Browser;`,shardBinding:{clientType:"Browser",missingMessage:"ctx.browser: provide a \\`browser\\` config thunk, e.g. \\`browser: (env) => createBrowser({ binding: env.BROWSER, launch })\\` with \\`import { launch } from '@cloudflare/playwright'\\`. Session reuse (connect/sessions) additionally needs those two exports passed the same way.",stubMethods:["cancelCrawl","connect","content","crawl","crawlResult","launch","pdf","quickAction","scrape","screenshot","sessions"]},tier:"action"},{contextProperty:"containers",key:"container",moduleSpecifier:"@lunora/container"},{contextProperty:"flags",key:"flags",moduleSpecifier:"@lunora/flags"},{appMethod:{configKey:"sql",doc:"Wire the Hyperdrive SQL client backing `ctx.sql` — build it with `createHyperdrive` + `fromPostgresJs`/`fromNodePg`/`fromMysql2`.",method:"hyperdrive"},contextProperty:"sql",key:"hyperdrive",moduleSpecifier:"@lunora/hyperdrive",requiredPackage:"@lunora/hyperdrive",serverCtxField:`
|
|
8
|
+
/**
|
|
9
|
+
* External database access via Hyperdrive. Non-deterministic — available only in actions. Writes here are NOT tracked by Lunora live queries; subscriptions will not re-run on external DB changes.
|
|
10
|
+
*/
|
|
11
|
+
readonly sql: import("@lunora/hyperdrive").SqlClient;`,shardBinding:{clientType:"SqlClient",missingMessage:"ctx.sql: provide a \\`sql\\` config thunk that builds a SqlClient from your driver, e.g. \\`sql: (env) => fromPostgresJs(postgres(env.HYPERDRIVE.connectionString))\\`.",stubMethods:["query"]},tier:"action"},{appMethod:{configKey:"images",doc:"Override the Images binding backing `ctx.images` (defaults to `env.IMAGES`).",method:"images"},contextProperty:"images",key:"images",moduleSpecifier:"@lunora/bindings/images",requiredPackage:"@lunora/bindings",serverCtxField:`
|
|
12
|
+
/** Cloudflare Images transforms (resize/format/optimize). Non-deterministic — available only in actions. */
|
|
13
|
+
readonly images: import("@lunora/bindings/images").Images;`,shardBinding:{binding:{bindingType:"ImagesBindingLike",envName:"IMAGES",factory:{name:"createImages",option:"binding"}},clientType:"Images",missingMessage:"ctx.images: no Images binding found. Add an \\`images\\` binding (env.IMAGES) to wrangler.jsonc, or pass \\`images\\` to createShardDO().",stubMethods:["info","transform"]},tier:"action"},{appMethod:{configKey:"kv",doc:"Override the Workers KV binding backing `ctx.kv` (defaults to `env.KV`).",method:"kv"},contextProperty:"kv",key:"kv",moduleSpecifier:"@lunora/bindings/kv",requiredPackage:"@lunora/bindings",serverCtxField:`
|
|
14
|
+
readonly kv: import("@lunora/bindings/kv").Kv;`,shardBinding:{binding:{bindingType:"KVNamespaceLike",envName:"KV",factory:{name:"createKv",option:"namespace"},unvouchableReads:["get","getRaw","getWithMetadata","list"]},clientType:"Kv",missingMessage:"ctx.kv: no KV binding found. Add a \\`kv_namespaces\\` binding (env.KV) to wrangler.jsonc, or pass \\`kv\\` to createShardDO().",stubMethods:["delete","get","getRaw","getWithMetadata","list","put"]},tier:"every"},{key:"mail",moduleSpecifier:"@lunora/mail"},{contextProperty:"notify",key:"notify",moduleSpecifier:"@lunora/notify"},{appMethod:{configKey:"payment",doc:"Wire the payment options backing `ctx.payments`.",method:"payment"},contextProperty:"payments",key:"payments",moduleSpecifier:"@lunora/payment",requiredPackage:"@lunora/payment"},{appMethod:{configKey:"x402",doc:"Wire the x402 agent-wallet pay rail backing `ctx.x402` — a payment-enabled `fetch` that answers `402` challenges under a mandatory spend policy (ActionCtx-only; spends real funds).",method:"x402"},contextProperty:"x402",key:"x402",moduleSpecifier:"@lunora/x402/pay",requiredPackage:"@lunora/x402"},{contextProperty:"pipelines",key:"pipelines",moduleSpecifier:"@lunora/bindings/pipelines",requiredPackage:"@lunora/bindings",serverCtxField:`
|
|
15
|
+
/** Pipelines ingestion sink (durable, R2-backed). Fire-and-forget and batched; do not read it back in-handler. */
|
|
16
|
+
readonly pipelines: import("@lunora/bindings/pipelines").PipelineClient;`,shardBinding:{binding:{bindingType:"PipelineBindingLike",envName:"PIPELINES",factory:{name:"createPipelines",option:"binding"}},clientType:"PipelineClient",missingMessage:"ctx.pipelines: no Pipelines binding found. Add a \\`pipelines\\` binding (env.PIPELINES) to wrangler.jsonc, or pass \\`pipelines\\` to createShardDO().",stubMethods:["send"]},tier:"action"},{appMethod:{configKey:"r2sql",doc:"Wire the R2 SQL client backing `ctx.r2sql` — build it with `createR2Sql({ accountId, apiToken, bucket })` (defaults to env `R2_SQL_TOKEN` / `R2_SQL_ACCOUNT_ID` / `R2_SQL_BUCKET`).",method:"r2sql"},contextProperty:"r2sql",key:"r2sql",moduleSpecifier:"@lunora/bindings/r2sql",requiredPackage:"@lunora/bindings",serverCtxField:`
|
|
17
|
+
/**
|
|
18
|
+
* R2 SQL over Apache Iceberg tables (window functions, DISTINCT, set operations). Non-deterministic — available only in actions. Reads here are NOT tracked by Lunora live queries.
|
|
19
|
+
*/
|
|
20
|
+
readonly r2sql: import("@lunora/bindings/r2sql").R2SqlClient;`,shardBinding:"bespoke",tier:"action"},{contextProperty:"scheduler",key:"scheduler",moduleSpecifier:"@lunora/scheduler"},{contextProperty:"storage",key:"storage",moduleSpecifier:"@lunora/storage"},{appMethod:{configKey:"vectors",doc:"Wire the Vectorize index map backing `ctx.vectors`.",method:"vectors"},contextProperty:"vectors",key:"vectors",moduleSpecifier:"@lunora/bindings/vectors"},{contextProperty:"workflows",key:"workflows",moduleSpecifier:"@lunora/workflow"}],t=n,a=n.flatMap(e=>"appMethod"in e?[{appMethod:e.appMethod,key:e.key}]:[]),r=e=>new Set(t.filter(i=>e[i.key]).map(i=>i.key));export{a as A,t as C,r as u};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import{w as a}from"./classify-procedure-call-CmcShAze.mjs";const l=s=>a(s,"use","rls");export{l as r};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import{Node as o}from"ts-morph";import{unwrapExpression as a}from"./listLunoraSourceFiles-CSlcBYlo.mjs";import{a as u}from"./module-specifiers-WF8iAydP.mjs";const A=t=>o.isIdentifier(t)?t.getText():o.isPropertyAccessExpression(t)?t.getName():void 0,y=(t,i)=>{const e=new Set;for(const r of t.getImportDeclarations())if(u(r.getModuleSpecifierValue()))for(const n of r.getNamedImports())n.getNameNode().getText()===i&&e.add(n.getAliasNode()?.getText()??n.getName());return e},h=(t,i)=>{if(o.isPropertyAccessExpression(t))return t.getName()===i;if(!o.isIdentifier(t))return!1;const e=t.getText();return e===i||y(t.getSourceFile(),i).has(e)},d=t=>{const i=t.getSymbol();if(!i)return t.getText();for(const e of i.getDeclarations())if(o.isImportSpecifier(e))return u(e.getImportDeclaration().getModuleSpecifierValue())?e.getNameNode().getText():void 0},p=t=>{const i=[];let e=a(t);for(;e&&o.isCallExpression(e);){const r=a(e.getExpression());if(!r||!o.isPropertyAccessExpression(r))return{root:void 0,steps:i};i.push({call:e,name:r.getName()}),e=a(r.getExpression())}return{root:e,steps:i}},f=t=>p(t).steps,x=(t,i,e)=>f(t).filter(r=>r.name===i).map(r=>r.call.getArguments()[0]).filter(r=>r!==void 0&&o.isCallExpression(r)&&h(r.getExpression(),e)),w=(t,i)=>f(t).some(e=>e.name===i),P=(t,i,e)=>x(t,i,e).length>0,l=new Set(["action","mutation","query","stream"]),m={internalAction:"action",internalMutation:"mutation",internalQuery:"query"},N={onConnect:"connect",onDisconnect:"disconnect",onQueryChange:"reactor",onShardInit:"init",onWhisper:"whisper"},I=t=>t==="whisper"?"query":"mutation",C=t=>{const{root:i}=p(t);return i&&o.isIdentifier(i)?i:void 0},g=(t,i=!1)=>{const e=C(t);if(!e)return;const r=d(e);if(r===void 0){if(i)return;const n=e.getSymbol()?.getValueDeclaration();if(n&&o.isVariableDeclaration(n)){const s=n.getInitializer();return s?g(s,!0):void 0}return}return l.has(r)?"public":m[r]?"internal":void 0},E=t=>{const i=t.getName();if(!l.has(i))return;const e=t.getExpression(),r=a(e)??e,n=e===r?[r]:[e,r];if(n.some(c=>c.getType().getProperty("__lunoraProcedure"))){const c=n.some(v=>v.getType().getProperty("__lunoraVisibility"));return{kind:i,receiver:r,visibility:c?"internal":"public"}}const s=g(r);if(s)return{kind:i,receiver:r,visibility:s}},D=t=>{const i=t.getExpression();if(o.isPropertyAccessExpression(i))return E(i);if(!o.isIdentifier(i))return;const e=d(i);if(!e)return;if(l.has(e))return{kind:e,visibility:"public"};const r=m[e];if(r)return{kind:r,visibility:"internal"};const n=N[e];if(n)return{kind:I(n),lifecycle:n,visibility:"internal"}};export{A as a,f as b,D as c,P as d,w as e,x as w};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import{Node as s,SyntaxKind as a}from"ts-morph";import{listLunoraSourceFiles as d,lunoraRelativePath as l,handlerOf as f}from"./listLunoraSourceFiles-CSlcBYlo.mjs";import{c as u}from"./classify-procedure-call-CmcShAze.mjs";const x=e=>{const n=e.getInitializer();if(!n||!s.isCallExpression(n))return;const r=u(n);if(!r||r.kind!=="query"&&r.kind!=="mutation")return;const t=f(n,r.receiver);return t?{exportName:e.getName(),handler:t,kind:r.kind}:void 0},p=(e,n)=>{if(!s.isPropertyAccessExpression(e)||e.getName()!==n)return;const r=e.getExpression();if(!s.isIdentifier(r)||r.getText()!=="ctx")return;const t=e.getParent();return t&&s.isPropertyAccessExpression(t)&&t.getExpression()===e?`ctx.${n}.${t.getName()}`:`ctx.${n}`},m=(e,n,r)=>{const t=[];for(const o of e.handler.getDescendantsOfKind(a.PropertyAccessExpression)){const i=p(o,r);i!==void 0&&t.push({callee:i,exportName:e.exportName,file:n,kind:e.kind,line:o.getStartLineNumber()})}return t},g=(e,n,r)=>{const t=[];for(const o of e.getVariableStatements())if(o.isExported())for(const i of o.getDeclarations()){const c=x(i);c&&t.push(...m(c,n,r))}return t},N=(e,n,r)=>{const t=[];for(const o of d(n)){const i=e.getSourceFile(o)??e.addSourceFileAtPath(o);t.push(...g(i,l(n,o),r))}return t};export{N as d};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import{SyntaxKind as a,Node as f}from"ts-morph";import{C as d}from"./capabilities-CqnIsyA9.mjs";import{bindingKeyName as m,listLunoraSourceFiles as p}from"./listLunoraSourceFiles-CSlcBYlo.mjs";const l="ctx",g=n=>{const s=new Set,o=new Set([l]),r=e=>{if(f.isObjectBindingPattern(e))for(const i of e.getElements()){const t=m(i);t&&s.add(t)}};for(const e of n.getDescendantsOfKind(a.BindingElement)){if(m(e)!==l)continue;const i=e.getNameNode();f.isIdentifier(i)?o.add(i.getText()):r(i)}const c=e=>f.isIdentifier(e)&&o.has(e.getText());for(const e of n.getDescendantsOfKind(a.PropertyAccessExpression))c(e.getExpression())&&s.add(e.getName());for(const e of n.getDescendantsOfKind(a.VariableDeclaration)){const i=e.getInitializer();i!==void 0&&c(i)&&r(e.getNameNode())}return s},u=n=>{if(n.isTypeOnly())return!0;const s=n.getNamedImports();return n.getDefaultImport()===void 0&&n.getNamespaceImport()===void 0&&s.length>0&&s.every(o=>o.isTypeOnly())},P=(n,s)=>{const o=Object.fromEntries(d.map(r=>[r.key,!1]));for(const r of p(s)){const c=n.getSourceFile(r)??n.addSourceFileAtPath(r),e=new Set(c.getImportDeclarations().filter(t=>!u(t)).map(t=>t.getModuleSpecifierValue())),i=g(c);for(const t of d)if(!o[t.key]){if(e.has(t.moduleSpecifier)){o[t.key]=!0;continue}t.contextProperty!==void 0&&i.has(t.contextProperty)&&(o[t.key]=!0)}if(d.every(t=>o[t.key]))break}return o};export{g as contextPropertiesRead,P as discoverFeatureUsage};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
const u=t=>t.output!==void 0&&t.output.kind!=="any"&&t.kind!=="stream";export{u as d};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
const o=r=>[...new Set(r)].toSorted((e,a)=>e.localeCompare(a)),s=r=>o(r.filter(e=>e.level==="ERROR").map(e=>e.name)),t=r=>o(r.filter(e=>e.level==="error").map(e=>e.name)),i=r=>({advisoryNames:s(r.advisories),platformDiagnosticNames:t(r.platformDiagnostics)});export{i as describeErrorLevelFindings,s as errorAdvisoryNames,t as errorPlatformDiagnosticNames,o as sortedUniqueNames};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
import{SyntaxKind as u,Node as r}from"ts-morph";import{listLunoraSourceFiles as f,lunoraRelativePath as g,enclosingExportName as d,propertyKeyName as m}from"./listLunoraSourceFiles-CSlcBYlo.mjs";const h=s=>{const t=s.getExpression();if(!r.isPropertyAccessExpression(t))return!1;const e=t.getExpression();return r.isPropertyAccessExpression(e)?e.getName()==="authApi":r.isIdentifier(e)&&e.getText()==="authApi"},A=s=>{const t=s.getArguments()[0];if(t===void 0)return!1;if(!r.isObjectLiteralExpression(t))return!0;for(const e of t.getProperties())if((r.isPropertyAssignment(e)||r.isShorthandPropertyAssignment(e))&&m(e)==="headers"||r.isSpreadAssignment(e))return!0;return!1},E=(s,t)=>{const e=[];for(const n of f(t)){const c=s.getSourceFile(n)??s.addSourceFileAtPath(n),l=g(t,n);for(const i of c.getDescendantsOfKind(u.CallExpression)){if(!h(i))continue;const o=d(i);if(o==="")continue;const a=i.getExpression(),p=r.isPropertyAccessExpression(a)?a.getName():"";e.push({exportName:o,file:l,hasHeaders:A(i),line:i.getStartLineNumber(),method:p})}}return e};export{E as default};
|