feat: add canonical OAuth fixtures

.changeset/canonical-oauth-fixtures.md

@@ -0,0 +1,5 @@
+---
+'@ankhorage/templates': minor
+---
+
+Add canonical Google, Apple, and combined OAuth manifest fixtures, and remove template-owned OAuth provider screen generation so Studio remains the single auth UI/runtime owner.

README.md

@@ -3,7 +3,7 @@
 
 # TEMPLATES
 
-![license: MIT](././docs/badges/license.svg) ![npm: v2.0.0](././docs/badges/npm.svg) ![runtime: bun](././docs/badges/runtime.svg) ![typescript: strict](././docs/badges/typescript.svg) ![eslint: checked](././docs/badges/eslint.svg) ![prettier: checked](././docs/badges/prettier.svg) ![build: checked](././docs/badges/build.svg) ![tests: checked](././docs/badges/tests.svg) ![docs: paradox](././docs/badges/docs.svg)
+![license: MIT](././docs/badges/license.svg) ![npm: v2.1.0](././docs/badges/npm.svg) ![runtime: bun](././docs/badges/runtime.svg) ![typescript: strict](././docs/badges/typescript.svg) ![eslint: checked](././docs/badges/eslint.svg) ![prettier: checked](././docs/badges/prettier.svg) ![build: checked](././docs/badges/build.svg) ![tests: checked](././docs/badges/tests.svg) ![docs: paradox](././docs/badges/docs.svg)
 
 Reusable Ankhorage app templates, presets, and manifest generators.
 
@@ -22,6 +22,8 @@ bunx @ankhorage/templates
 - [Module relationships](././docs/diagrams/module-relationships.mmd)
 - [Export graph](././docs/diagrams/export-graph.mmd)
 - [ankhorage-templates sequence](././docs/diagrams/sequences/ankhorage-templates.mmd)
+- [createCategoryAppManifest sequence](././docs/diagrams/sequences/create-category-app-manifest.mmd)
+- [createOAuthFixtureManifest sequence](././docs/diagrams/sequences/create-oauth-fixture-manifest.mmd)
 - [createStarterTemplate sequence](././docs/diagrams/sequences/create-starter-template.mmd)
 - [listStarterTemplatesByCategory sequence](././docs/diagrams/sequences/list-starter-templates-by-category.mmd)
 - [resolveStarterTemplate sequence](././docs/diagrams/sequences/resolve-starter-template.mmd)

docs/diagrams/architecture-overview.mmd

@@ -30,13 +30,17 @@ graph TD
   module_src_commands_ts --> module_src_projectSeed_ts
   module_src_commands_ts --> module_src_templates_starter_index_ts
   module_src_commands_ts --> module_src_templateSelector_ts
+  module_src_fixtures_oauth_ts["src/fixtures/oauth.ts"]
+  package__ankhorage_templates -.-> module_src_fixtures_oauth_ts
+  module_src_fixtures_oauth_ts --> module_src_generators_create_category_app_ts
+  module_src_fixtures_oauth_ts --> module_src_internal_merge_ts
+  module_src_fixtures_oauth_ts --> module_src_internal_overrides_ts
+  module_src_fixtures_oauth_ts --> module_src_templates_starter_index_ts
   module_src_generators_create_category_app_ts["src/generators/create-category-app.ts"]
   package__ankhorage_templates -.-> module_src_generators_create_category_app_ts
   module_src_generators_create_category_app_ts --> module_src_internal_merge_ts
   module_src_generators_create_category_app_ts --> module_src_internal_overrides_ts
   module_src_generators_create_category_app_ts --> module_src_presets_category_presets_ts
-  module_src_generators_create_category_app_ts --> module_src_templates_shared_screen_ts
-  module_src_generators_create_category_app_ts --> module_src_templates_shared_zora_node_helpers_ts
   module_src_generators_create_category_app_ts --> module_src_templates_starter_index_ts
   module_src_index_ts["src/index.ts"]
   module_src_internal_defaults_ts["src/internal/defaults.ts"]

docs/diagrams/export-graph.mmd

@@ -5,6 +5,7 @@ graph LR
   module_src_cli_standalone_ts["src/cli/standalone.ts"]
   module_src_commandContext_ts["src/commandContext.ts"]
   module_src_commands_ts["src/commands.ts"]
+  module_src_fixtures_oauth_ts["src/fixtures/oauth.ts"]
   module_src_generators_create_category_app_ts["src/generators/create-category-app.ts"]
   module_src_index_ts["src/index.ts"]
   module_src_internal_defaults_ts["src/internal/defaults.ts"]
@@ -188,10 +189,18 @@ graph LR
   export_createCategoryAppManifest["createCategoryAppManifest"]
   module_src_generators_create_category_app_ts --> export_createCategoryAppManifest
   export_createCategoryAppManifest -.-> export_SplashScreenResizeMode
+  export_createOAuthFixtureManifest["createOAuthFixtureManifest"]
+  module_src_fixtures_oauth_ts --> export_createOAuthFixtureManifest
+  export_createOAuthFixtureManifest -.-> export_AppCategory
+  export_createOAuthFixtureManifest -.-> export_OAuthFixtureId
+  export_createOAuthFixtureManifest -.-> export_TemplateKind
   export_createStarterTemplate["createStarterTemplate"]
   module_src_templates_starter_starter_template_ts --> export_createStarterTemplate
   export_createStarterTemplate -.-> export_StarterTemplateOptions
   export_createStarterTemplate -.-> export_TemplateSeed
+  export_listOAuthFixtures["listOAuthFixtures"]
+  module_src_fixtures_oauth_ts --> export_listOAuthFixtures
+  export_listOAuthFixtures -.-> export_OAuthFixtureDefinition
   export_listStarterTemplates["listStarterTemplates"]
   module_src_templates_starter_starter_registry_ts --> export_listStarterTemplates
   export_listStarterTemplates -.-> export_CategoryStarterTemplateDefinition
@@ -201,6 +210,17 @@ graph LR
   export_listStarterTemplateSummaries["listStarterTemplateSummaries"]
   module_src_templates_starter_starter_registry_ts --> export_listStarterTemplateSummaries
   export_listStarterTemplateSummaries -.-> export_StarterTemplateSummary
+  export_OAUTH_CALLBACK_ROUTE["OAUTH_CALLBACK_ROUTE"]
+  module_src_fixtures_oauth_ts --> export_OAUTH_CALLBACK_ROUTE
+  export_OAUTH_FIXTURE_IDS["OAUTH_FIXTURE_IDS"]
+  module_src_fixtures_oauth_ts --> export_OAUTH_FIXTURE_IDS
+  export_OAuthFixtureDefinition["OAuthFixtureDefinition"]
+  module_src_fixtures_oauth_ts --> export_OAuthFixtureDefinition
+  export_OAuthFixtureId["OAuthFixtureId"]
+  module_src_fixtures_oauth_ts --> export_OAuthFixtureId
+  export_resolveOAuthFixture["resolveOAuthFixture"]
+  module_src_fixtures_oauth_ts --> export_resolveOAuthFixture
+  export_resolveOAuthFixture -.-> export_OAuthFixtureDefinition
   export_resolveStarterTemplate["resolveStarterTemplate"]
   module_src_templates_starter_starter_registry_ts --> export_resolveStarterTemplate
   export_resolveStarterTemplate -.-> export_CategoryStarterTemplateDefinition

docs/diagrams/module-relationships.mmd

@@ -5,6 +5,7 @@ graph LR
   module_src_cli_standalone_ts["src/cli/standalone.ts"]
   module_src_commandContext_ts["src/commandContext.ts"]
   module_src_commands_ts["src/commands.ts"]
+  module_src_fixtures_oauth_ts["src/fixtures/oauth.ts"]
   module_src_generators_create_category_app_ts["src/generators/create-category-app.ts"]
   module_src_index_ts["src/index.ts"]
   module_src_internal_defaults_ts["src/internal/defaults.ts"]
@@ -190,11 +191,13 @@ graph LR
   module_src_commands_ts --> module_src_projectSeed_ts
   module_src_commands_ts --> module_src_templates_starter_index_ts
   module_src_commands_ts --> module_src_templateSelector_ts
+  module_src_fixtures_oauth_ts --> module_src_generators_create_category_app_ts
+  module_src_fixtures_oauth_ts --> module_src_internal_merge_ts
+  module_src_fixtures_oauth_ts --> module_src_internal_overrides_ts
+  module_src_fixtures_oauth_ts --> module_src_templates_starter_index_ts
   module_src_generators_create_category_app_ts --> module_src_internal_merge_ts
   module_src_generators_create_category_app_ts --> module_src_internal_overrides_ts
   module_src_generators_create_category_app_ts --> module_src_presets_category_presets_ts
-  module_src_generators_create_category_app_ts --> module_src_templates_shared_screen_ts
-  module_src_generators_create_category_app_ts --> module_src_templates_shared_zora_node_helpers_ts
   module_src_generators_create_category_app_ts --> module_src_templates_starter_index_ts
   module_src_internal_merge_ts --> module_src_internal_overrides_ts
   module_src_packageMetadata_ts --> module_package_json

docs/diagrams/sequences/create-category-app-manifest.mmd

@@ -0,0 +1,19 @@
+sequenceDiagram
+  participant participant___type as __type
+  participant participant_createCategoryAppManifest as createCategoryAppManifest
+  participant participant_createManifestFromTemplate as createManifestFromTemplate
+  participant participant_isPlainObject as isPlainObject
+  participant participant_mergeAppManifest as mergeAppManifest
+  participant participant_mergeValue as mergeValue
+  participant_createCategoryAppManifest->>participant_createManifestFromTemplate: createManifestFromTemplate()
+  participant_createManifestFromTemplate->>participant___type: TEMPLATE_FACTORIES[template]()
+  participant___type-->>participant_createManifestFromTemplate: return
+  participant_createManifestFromTemplate-->>participant_createCategoryAppManifest: return
+  participant_createCategoryAppManifest->>participant_mergeAppManifest: mergeAppManifest()
+  participant_mergeAppManifest->>participant_mergeValue: mergeValue()
+  participant_mergeValue->>participant_isPlainObject: isPlainObject()
+  participant_isPlainObject-->>participant_mergeValue: return
+  participant_mergeValue->>participant_mergeValue: mergeValue()
+  participant_mergeValue-->>participant_mergeValue: return
+  participant_mergeValue-->>participant_mergeAppManifest: return
+  participant_mergeAppManifest-->>participant_createCategoryAppManifest: return

docs/diagrams/sequences/create-oauth-fixture-manifest.mmd

@@ -0,0 +1,27 @@
+sequenceDiagram
+  participant participant___type as __type
+  participant participant_createCategoryAppManifest as createCategoryAppManifest
+  participant participant_createManifestFromTemplate as createManifestFromTemplate
+  participant participant_createOAuthFixtureManifest as createOAuthFixtureManifest
+  participant participant_isPlainObject as isPlainObject
+  participant participant_mergeAppManifest as mergeAppManifest
+  participant participant_mergeValue as mergeValue
+  participant participant_resolveOAuthFixture as resolveOAuthFixture
+  participant_createOAuthFixtureManifest->>participant_createCategoryAppManifest: createCategoryAppManifest()
+  participant_createCategoryAppManifest->>participant_createManifestFromTemplate: createManifestFromTemplate()
+  participant_createManifestFromTemplate->>participant___type: TEMPLATE_FACTORIES[template]()
+  participant___type-->>participant_createManifestFromTemplate: return
+  participant_createManifestFromTemplate-->>participant_createCategoryAppManifest: return
+  participant_createCategoryAppManifest->>participant_mergeAppManifest: mergeAppManifest()
+  participant_mergeAppManifest->>participant_mergeValue: mergeValue()
+  participant_mergeValue->>participant_isPlainObject: isPlainObject()
+  participant_isPlainObject-->>participant_mergeValue: return
+  participant_mergeValue->>participant_mergeValue: mergeValue()
+  participant_mergeValue-->>participant_mergeValue: return
+  participant_mergeValue-->>participant_mergeAppManifest: return
+  participant_mergeAppManifest-->>participant_createCategoryAppManifest: return
+  participant_createCategoryAppManifest-->>participant_createOAuthFixtureManifest: return
+  participant_createOAuthFixtureManifest->>participant_resolveOAuthFixture: resolveOAuthFixture()
+  participant_resolveOAuthFixture-->>participant_createOAuthFixtureManifest: return
+  participant_createOAuthFixtureManifest->>participant_mergeAppManifest: mergeAppManifest()
+  participant_mergeAppManifest-->>participant_createOAuthFixtureManifest: return