@strapi/typescript-utils 0.0.0-experimental.6340da17068c3bed7fb006e7bcc554c71129e282 → 0.0.0-experimental.63624e21eb5b0713345a0cf2f68f1c40eab427bc

package/dist/generators/policies/index.js

@@ -0,0 +1,135 @@
+'use strict';
+
+var ts = require('typescript');
+var sources = require('../common/sources.js');
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var ts__namespace = /*#__PURE__*/_interopNamespace(ts);
+
+const { factory } = ts__namespace;
+const REGISTRY = 'AppPolicies';
+const CONFIG_HELPER = 'PolicyConfig';
+const HANDLER_CONFIG_HELPER = 'PolicyHandlerConfig';
+const NO_POLICY_PLACEHOLDER_COMMENT = `/*
+ * The app doesn't have any policies yet.
+ */
+
+export {};
+`;
+/**
+ * type PolicyHandlerConfig<THandler> = THandler extends (...args: infer TArgs) => unknown
+ *   ? TArgs['length'] extends 0 | 1 ? undefined : 0 extends 1 & TArgs[1] ? unknown : TArgs[1]
+ *   : unknown;
+ *
+ * type PolicyConfig<TModule> = TModule extends { default: infer TExport }
+ *   ? PolicyHandlerConfig<TExport extends { handler: infer THandler } ? THandler : TExport>
+ *   : unknown;
+ *
+ * Emitted in the file so that policies.ts stands alone, like the services and controllers helpers,
+ * and only when a TypeScript policy reads them.
+ *
+ * Resolves the config a policy accepts from the type of its module: the second parameter of its
+ * handler, for both runtime forms (a bare handler, or `{ handler, validator }`). A handler without
+ * a config parameter takes none: `undefined`, as in PackagePolicies. An untyped (`any`) config and a
+ * module without a default export resolve to `unknown`: one `any` entry would turn every policy
+ * reference into `any`.
+ * TODO @Nico a module without a default export registers nothing usable at runtime (resolving it
+ * throws); `unknown` accepts any reference to it, like an untyped policy
+ */ const generateConfigHelpersDefinition = ()=>{
+    const args = factory.createTypeReferenceNode('TArgs');
+    const configArg = factory.createIndexedAccessTypeNode(args, factory.createLiteralTypeNode(factory.createNumericLiteral(1)));
+    const handlerConfig = factory.createConditionalTypeNode(factory.createTypeReferenceNode('THandler'), factory.createFunctionTypeNode(undefined, [
+        factory.createParameterDeclaration(undefined, factory.createToken(ts__namespace.SyntaxKind.DotDotDotToken), 'args', undefined, factory.createInferTypeNode(factory.createTypeParameterDeclaration(undefined, 'TArgs')))
+    ], factory.createKeywordTypeNode(ts__namespace.SyntaxKind.UnknownKeyword)), factory.createConditionalTypeNode(factory.createIndexedAccessTypeNode(args, factory.createLiteralTypeNode(factory.createStringLiteral('length', true))), factory.createUnionTypeNode([
+        factory.createLiteralTypeNode(factory.createNumericLiteral(0)),
+        factory.createLiteralTypeNode(factory.createNumericLiteral(1))
+    ]), factory.createKeywordTypeNode(ts__namespace.SyntaxKind.UndefinedKeyword), // 0 extends 1 & TArgs[1], true only when the config is `any`
+    factory.createConditionalTypeNode(factory.createLiteralTypeNode(factory.createNumericLiteral(0)), factory.createIntersectionTypeNode([
+        factory.createLiteralTypeNode(factory.createNumericLiteral(1)),
+        configArg
+    ]), factory.createKeywordTypeNode(ts__namespace.SyntaxKind.UnknownKeyword), configArg)), factory.createKeywordTypeNode(ts__namespace.SyntaxKind.UnknownKeyword));
+    const unwrapHandler = factory.createConditionalTypeNode(factory.createTypeReferenceNode('TExport'), factory.createTypeLiteralNode([
+        factory.createPropertySignature(undefined, 'handler', undefined, factory.createInferTypeNode(factory.createTypeParameterDeclaration(undefined, 'THandler')))
+    ]), factory.createTypeReferenceNode('THandler'), factory.createTypeReferenceNode('TExport'));
+    const moduleConfig = factory.createConditionalTypeNode(factory.createTypeReferenceNode('TModule'), factory.createTypeLiteralNode([
+        factory.createPropertySignature(undefined, 'default', undefined, factory.createInferTypeNode(factory.createTypeParameterDeclaration(undefined, 'TExport')))
+    ]), factory.createTypeReferenceNode(HANDLER_CONFIG_HELPER, [
+        unwrapHandler
+    ]), factory.createKeywordTypeNode(ts__namespace.SyntaxKind.UnknownKeyword));
+    return [
+        sources.withDocComment(factory.createTypeAliasDeclaration(undefined, factory.createIdentifier(HANDLER_CONFIG_HELPER), [
+            factory.createTypeParameterDeclaration(undefined, 'THandler')
+        ], handlerConfig), '*\n * Config a policy handler accepts: its second parameter, `undefined` when it has none, `unknown`\n * when it is untyped.\n '),
+        sources.withDocComment(factory.createTypeAliasDeclaration(undefined, factory.createIdentifier(CONFIG_HELPER), [
+            factory.createTypeParameterDeclaration(undefined, 'TModule')
+        ], moduleConfig), '*\n * Config accepted by the policy a policy module exports, as a bare handler or as\n * `{ handler, validator }`.\n ')
+    ];
+};
+/**
+ * Generate type definitions for the application's policies (global::* and api::*)
+ *
+ * Policies are typed from their source file, so only the ones with a source in src/policies or
+ * src/api are emitted. Plugin and admin policies are left to the packages themselves
+ * (Strapi.Registries.PackagePolicies), so registering application policies keeps them accepted.
+ *
+ * declare global {
+ *   namespace Strapi {
+ *     namespace Registries {
+ *       interface AppPolicies {
+ *         'global::<policy>': PolicyConfig<typeof import('<relative path to the source>')>;
+ *         'api::<api>.<policy>': PolicyConfig<typeof import('<relative path to the source>')>;
+ *         'global::<js policy>': unknown;
+ *       }
+ *     }
+ *   }
+ * }
+ *
+ * The import of a JS policy is an error type without `allowJs`, and one such entry turns every policy
+ * reference into `any`. JS policies are registered as `unknown` without an import.
+ * TODO @Nico with `allowJs`, a JSDoc-typed JS policy could register its config like a TS one
+ */ const generatePoliciesDefinitions = async (options = {})=>{
+    const { strapi, logger, pwd: outDir } = options;
+    if (!outDir) {
+        throw new Error('The policies generator needs the output directory to resolve source imports');
+    }
+    const sources$1 = await sources.collectAppSources('policies', {
+        global: strapi.dirs.app.policies,
+        api: strapi.dirs.app.api
+    }, outDir, logger);
+    const policiesDefinitions = sources.filterRegisteredSources(sources$1, strapi.policies, logger);
+    logger.debug(`Found ${policiesDefinitions.length} policies.`);
+    if (policiesDefinitions.length === 0) {
+        return {
+            output: NO_POLICY_PLACEHOLDER_COMMENT,
+            stats: {}
+        };
+    }
+    // The helpers are only emitted when an entry reads them: `noUnusedLocals` reports unused ones
+    const output = await sources.emitRegistryDefinitions(REGISTRY, policiesDefinitions.some(sources.isTypedSource) === true ? generateConfigHelpersDefinition() : [], policiesDefinitions, (source)=>sources.isTypedSource(source) ? factory.createTypeReferenceNode(CONFIG_HELPER, [
+            sources.typeofImport(source)
+        ]) : factory.createKeywordTypeNode(ts__namespace.SyntaxKind.UnknownKeyword));
+    return {
+        output,
+        stats: {}
+    };
+};
+
+exports.generatePoliciesDefinitions = generatePoliciesDefinitions;
+//# sourceMappingURL=index.js.map

package/dist/generators/policies/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../src/generators/policies/index.ts"],"sourcesContent":["import * as ts from 'typescript';\n\nimport {\n  collectAppSources,\n  emitRegistryDefinitions,\n  filterRegisteredSources,\n  isTypedSource,\n  typeofImport,\n  withDocComment,\n} from '../common/sources';\nimport type { GeneratorOptions } from '../utils';\n\nconst { factory } = ts;\n\nconst REGISTRY = 'AppPolicies';\nconst CONFIG_HELPER = 'PolicyConfig';\nconst HANDLER_CONFIG_HELPER = 'PolicyHandlerConfig';\n\nconst NO_POLICY_PLACEHOLDER_COMMENT = `/*\n * The app doesn't have any policies yet.\n */\n\nexport {};\n`;\n\n/**\n * type PolicyHandlerConfig<THandler> = THandler extends (...args: infer TArgs) => unknown\n *   ? TArgs['length'] extends 0 | 1 ? undefined : 0 extends 1 & TArgs[1] ? unknown : TArgs[1]\n *   : unknown;\n *\n * type PolicyConfig<TModule> = TModule extends { default: infer TExport }\n *   ? PolicyHandlerConfig<TExport extends { handler: infer THandler } ? THandler : TExport>\n *   : unknown;\n *\n * Emitted in the file so that policies.ts stands alone, like the services and controllers helpers,\n * and only when a TypeScript policy reads them.\n *\n * Resolves the config a policy accepts from the type of its module: the second parameter of its\n * handler, for both runtime forms (a bare handler, or `{ handler, validator }`). A handler without\n * a config parameter takes none: `undefined`, as in PackagePolicies. An untyped (`any`) config and a\n * module without a default export resolve to `unknown`: one `any` entry would turn every policy\n * reference into `any`.\n * TODO @Nico a module without a default export registers nothing usable at runtime (resolving it\n * throws); `unknown` accepts any reference to it, like an untyped policy\n */\nconst generateConfigHelpersDefinition = () => {\n  const args = factory.createTypeReferenceNode('TArgs');\n  const configArg = factory.createIndexedAccessTypeNode(\n    args,\n    factory.createLiteralTypeNode(factory.createNumericLiteral(1))\n  );\n\n  const handlerConfig = factory.createConditionalTypeNode(\n    factory.createTypeReferenceNode('THandler'),\n    factory.createFunctionTypeNode(\n      undefined,\n      [\n        factory.createParameterDeclaration(\n          undefined,\n          factory.createToken(ts.SyntaxKind.DotDotDotToken),\n          'args',\n          undefined,\n          factory.createInferTypeNode(factory.createTypeParameterDeclaration(undefined, 'TArgs'))\n        ),\n      ],\n      factory.createKeywordTypeNode(ts.SyntaxKind.UnknownKeyword)\n    ),\n    factory.createConditionalTypeNode(\n      factory.createIndexedAccessTypeNode(\n        args,\n        factory.createLiteralTypeNode(factory.createStringLiteral('length', true))\n      ),\n      factory.createUnionTypeNode([\n        factory.createLiteralTypeNode(factory.createNumericLiteral(0)),\n        factory.createLiteralTypeNode(factory.createNumericLiteral(1)),\n      ]),\n      factory.createKeywordTypeNode(ts.SyntaxKind.UndefinedKeyword),\n      // 0 extends 1 & TArgs[1], true only when the config is `any`\n      factory.createConditionalTypeNode(\n        factory.createLiteralTypeNode(factory.createNumericLiteral(0)),\n        factory.createIntersectionTypeNode([\n          factory.createLiteralTypeNode(factory.createNumericLiteral(1)),\n          configArg,\n        ]),\n        factory.createKeywordTypeNode(ts.SyntaxKind.UnknownKeyword),\n        configArg\n      )\n    ),\n    factory.createKeywordTypeNode(ts.SyntaxKind.UnknownKeyword)\n  );\n\n  const unwrapHandler = factory.createConditionalTypeNode(\n    factory.createTypeReferenceNode('TExport'),\n    factory.createTypeLiteralNode([\n      factory.createPropertySignature(\n        undefined,\n        'handler',\n        undefined,\n        factory.createInferTypeNode(factory.createTypeParameterDeclaration(undefined, 'THandler'))\n      ),\n    ]),\n    factory.createTypeReferenceNode('THandler'),\n    factory.createTypeReferenceNode('TExport')\n  );\n\n  const moduleConfig = factory.createConditionalTypeNode(\n    factory.createTypeReferenceNode('TModule'),\n    factory.createTypeLiteralNode([\n      factory.createPropertySignature(\n        undefined,\n        'default',\n        undefined,\n        factory.createInferTypeNode(factory.createTypeParameterDeclaration(undefined, 'TExport'))\n      ),\n    ]),\n    factory.createTypeReferenceNode(HANDLER_CONFIG_HELPER, [unwrapHandler]),\n    factory.createKeywordTypeNode(ts.SyntaxKind.UnknownKeyword)\n  );\n\n  return [\n    withDocComment(\n      factory.createTypeAliasDeclaration(\n        undefined,\n        factory.createIdentifier(HANDLER_CONFIG_HELPER),\n        [factory.createTypeParameterDeclaration(undefined, 'THandler')],\n        handlerConfig\n      ),\n      '*\\n * Config a policy handler accepts: its second parameter, `undefined` when it has none, `unknown`\\n * when it is untyped.\\n '\n    ),\n    withDocComment(\n      factory.createTypeAliasDeclaration(\n        undefined,\n        factory.createIdentifier(CONFIG_HELPER),\n        [factory.createTypeParameterDeclaration(undefined, 'TModule')],\n        moduleConfig\n      ),\n      '*\\n * Config accepted by the policy a policy module exports, as a bare handler or as\\n * `{ handler, validator }`.\\n '\n    ),\n  ];\n};\n\n/**\n * Generate type definitions for the application's policies (global::* and api::*)\n *\n * Policies are typed from their source file, so only the ones with a source in src/policies or\n * src/api are emitted. Plugin and admin policies are left to the packages themselves\n * (Strapi.Registries.PackagePolicies), so registering application policies keeps them accepted.\n *\n * declare global {\n *   namespace Strapi {\n *     namespace Registries {\n *       interface AppPolicies {\n *         'global::<policy>': PolicyConfig<typeof import('<relative path to the source>')>;\n *         'api::<api>.<policy>': PolicyConfig<typeof import('<relative path to the source>')>;\n *         'global::<js policy>': unknown;\n *       }\n *     }\n *   }\n * }\n *\n * The import of a JS policy is an error type without `allowJs`, and one such entry turns every policy\n * reference into `any`. JS policies are registered as `unknown` without an import.\n * TODO @Nico with `allowJs`, a JSDoc-typed JS policy could register its config like a TS one\n */\nexport const generatePoliciesDefinitions = async (\n  options: GeneratorOptions = {} as GeneratorOptions\n) => {\n  const { strapi, logger, pwd: outDir } = options;\n\n  if (!outDir) {\n    throw new Error('The policies generator needs the output directory to resolve source imports');\n  }\n\n  const sources = await collectAppSources(\n    'policies',\n    { global: strapi.dirs.app.policies, api: strapi.dirs.app.api },\n    outDir,\n    logger\n  );\n  const policiesDefinitions = filterRegisteredSources(sources, strapi.policies, logger);\n\n  logger.debug(`Found ${policiesDefinitions.length} policies.`);\n\n  if (policiesDefinitions.length === 0) {\n    return { output: NO_POLICY_PLACEHOLDER_COMMENT, stats: {} };\n  }\n\n  // The helpers are only emitted when an entry reads them: `noUnusedLocals` reports unused ones\n  const output = await emitRegistryDefinitions(\n    REGISTRY,\n    policiesDefinitions.some(isTypedSource) === true ? generateConfigHelpersDefinition() : [],\n    policiesDefinitions,\n    (source) =>\n      isTypedSource(source)\n        ? factory.createTypeReferenceNode(CONFIG_HELPER, [typeofImport(source)])\n        : factory.createKeywordTypeNode(ts.SyntaxKind.UnknownKeyword)\n  );\n\n  return { output, stats: {} };\n};\n"],"names":["factory","ts","REGISTRY","CONFIG_HELPER","HANDLER_CONFIG_HELPER","NO_POLICY_PLACEHOLDER_COMMENT","generateConfigHelpersDefinition","args","createTypeReferenceNode","configArg","createIndexedAccessTypeNode","createLiteralTypeNode","createNumericLiteral","handlerConfig","createConditionalTypeNode","createFunctionTypeNode","undefined","createParameterDeclaration","createToken","SyntaxKind","DotDotDotToken","createInferTypeNode","createTypeParameterDeclaration","createKeywordTypeNode","UnknownKeyword","createStringLiteral","createUnionTypeNode","UndefinedKeyword","createIntersectionTypeNode","unwrapHandler","createTypeLiteralNode","createPropertySignature","moduleConfig","withDocComment","createTypeAliasDeclaration","createIdentifier","generatePoliciesDefinitions","options","strapi","logger","pwd","outDir","Error","sources","collectAppSources","global","dirs","app","policies","api","policiesDefinitions","filterRegisteredSources","debug","length","output","stats","emitRegistryDefinitions","some","isTypedSource","source","typeofImport"],"mappings":"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"}

package/dist/generators/policies/index.mjs

@@ -0,0 +1,113 @@
+import * as ts from 'typescript';
+import { collectAppSources, filterRegisteredSources, emitRegistryDefinitions, isTypedSource, withDocComment, typeofImport } from '../common/sources.mjs';
+
+const { factory } = ts;
+const REGISTRY = 'AppPolicies';
+const CONFIG_HELPER = 'PolicyConfig';
+const HANDLER_CONFIG_HELPER = 'PolicyHandlerConfig';
+const NO_POLICY_PLACEHOLDER_COMMENT = `/*
+ * The app doesn't have any policies yet.
+ */
+
+export {};
+`;
+/**
+ * type PolicyHandlerConfig<THandler> = THandler extends (...args: infer TArgs) => unknown
+ *   ? TArgs['length'] extends 0 | 1 ? undefined : 0 extends 1 & TArgs[1] ? unknown : TArgs[1]
+ *   : unknown;
+ *
+ * type PolicyConfig<TModule> = TModule extends { default: infer TExport }
+ *   ? PolicyHandlerConfig<TExport extends { handler: infer THandler } ? THandler : TExport>
+ *   : unknown;
+ *
+ * Emitted in the file so that policies.ts stands alone, like the services and controllers helpers,
+ * and only when a TypeScript policy reads them.
+ *
+ * Resolves the config a policy accepts from the type of its module: the second parameter of its
+ * handler, for both runtime forms (a bare handler, or `{ handler, validator }`). A handler without
+ * a config parameter takes none: `undefined`, as in PackagePolicies. An untyped (`any`) config and a
+ * module without a default export resolve to `unknown`: one `any` entry would turn every policy
+ * reference into `any`.
+ * TODO @Nico a module without a default export registers nothing usable at runtime (resolving it
+ * throws); `unknown` accepts any reference to it, like an untyped policy
+ */ const generateConfigHelpersDefinition = ()=>{
+    const args = factory.createTypeReferenceNode('TArgs');
+    const configArg = factory.createIndexedAccessTypeNode(args, factory.createLiteralTypeNode(factory.createNumericLiteral(1)));
+    const handlerConfig = factory.createConditionalTypeNode(factory.createTypeReferenceNode('THandler'), factory.createFunctionTypeNode(undefined, [
+        factory.createParameterDeclaration(undefined, factory.createToken(ts.SyntaxKind.DotDotDotToken), 'args', undefined, factory.createInferTypeNode(factory.createTypeParameterDeclaration(undefined, 'TArgs')))
+    ], factory.createKeywordTypeNode(ts.SyntaxKind.UnknownKeyword)), factory.createConditionalTypeNode(factory.createIndexedAccessTypeNode(args, factory.createLiteralTypeNode(factory.createStringLiteral('length', true))), factory.createUnionTypeNode([
+        factory.createLiteralTypeNode(factory.createNumericLiteral(0)),
+        factory.createLiteralTypeNode(factory.createNumericLiteral(1))
+    ]), factory.createKeywordTypeNode(ts.SyntaxKind.UndefinedKeyword), // 0 extends 1 & TArgs[1], true only when the config is `any`
+    factory.createConditionalTypeNode(factory.createLiteralTypeNode(factory.createNumericLiteral(0)), factory.createIntersectionTypeNode([
+        factory.createLiteralTypeNode(factory.createNumericLiteral(1)),
+        configArg
+    ]), factory.createKeywordTypeNode(ts.SyntaxKind.UnknownKeyword), configArg)), factory.createKeywordTypeNode(ts.SyntaxKind.UnknownKeyword));
+    const unwrapHandler = factory.createConditionalTypeNode(factory.createTypeReferenceNode('TExport'), factory.createTypeLiteralNode([
+        factory.createPropertySignature(undefined, 'handler', undefined, factory.createInferTypeNode(factory.createTypeParameterDeclaration(undefined, 'THandler')))
+    ]), factory.createTypeReferenceNode('THandler'), factory.createTypeReferenceNode('TExport'));
+    const moduleConfig = factory.createConditionalTypeNode(factory.createTypeReferenceNode('TModule'), factory.createTypeLiteralNode([
+        factory.createPropertySignature(undefined, 'default', undefined, factory.createInferTypeNode(factory.createTypeParameterDeclaration(undefined, 'TExport')))
+    ]), factory.createTypeReferenceNode(HANDLER_CONFIG_HELPER, [
+        unwrapHandler
+    ]), factory.createKeywordTypeNode(ts.SyntaxKind.UnknownKeyword));
+    return [
+        withDocComment(factory.createTypeAliasDeclaration(undefined, factory.createIdentifier(HANDLER_CONFIG_HELPER), [
+            factory.createTypeParameterDeclaration(undefined, 'THandler')
+        ], handlerConfig), '*\n * Config a policy handler accepts: its second parameter, `undefined` when it has none, `unknown`\n * when it is untyped.\n '),
+        withDocComment(factory.createTypeAliasDeclaration(undefined, factory.createIdentifier(CONFIG_HELPER), [
+            factory.createTypeParameterDeclaration(undefined, 'TModule')
+        ], moduleConfig), '*\n * Config accepted by the policy a policy module exports, as a bare handler or as\n * `{ handler, validator }`.\n ')
+    ];
+};
+/**
+ * Generate type definitions for the application's policies (global::* and api::*)
+ *
+ * Policies are typed from their source file, so only the ones with a source in src/policies or
+ * src/api are emitted. Plugin and admin policies are left to the packages themselves
+ * (Strapi.Registries.PackagePolicies), so registering application policies keeps them accepted.
+ *
+ * declare global {
+ *   namespace Strapi {
+ *     namespace Registries {
+ *       interface AppPolicies {
+ *         'global::<policy>': PolicyConfig<typeof import('<relative path to the source>')>;
+ *         'api::<api>.<policy>': PolicyConfig<typeof import('<relative path to the source>')>;
+ *         'global::<js policy>': unknown;
+ *       }
+ *     }
+ *   }
+ * }
+ *
+ * The import of a JS policy is an error type without `allowJs`, and one such entry turns every policy
+ * reference into `any`. JS policies are registered as `unknown` without an import.
+ * TODO @Nico with `allowJs`, a JSDoc-typed JS policy could register its config like a TS one
+ */ const generatePoliciesDefinitions = async (options = {})=>{
+    const { strapi, logger, pwd: outDir } = options;
+    if (!outDir) {
+        throw new Error('The policies generator needs the output directory to resolve source imports');
+    }
+    const sources = await collectAppSources('policies', {
+        global: strapi.dirs.app.policies,
+        api: strapi.dirs.app.api
+    }, outDir, logger);
+    const policiesDefinitions = filterRegisteredSources(sources, strapi.policies, logger);
+    logger.debug(`Found ${policiesDefinitions.length} policies.`);
+    if (policiesDefinitions.length === 0) {
+        return {
+            output: NO_POLICY_PLACEHOLDER_COMMENT,
+            stats: {}
+        };
+    }
+    // The helpers are only emitted when an entry reads them: `noUnusedLocals` reports unused ones
+    const output = await emitRegistryDefinitions(REGISTRY, policiesDefinitions.some(isTypedSource) === true ? generateConfigHelpersDefinition() : [], policiesDefinitions, (source)=>isTypedSource(source) ? factory.createTypeReferenceNode(CONFIG_HELPER, [
+            typeofImport(source)
+        ]) : factory.createKeywordTypeNode(ts.SyntaxKind.UnknownKeyword));
+    return {
+        output,
+        stats: {}
+    };
+};
+
+export { generatePoliciesDefinitions };
+//# sourceMappingURL=index.mjs.map

package/dist/generators/policies/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":["../../../src/generators/policies/index.ts"],"sourcesContent":["import * as ts from 'typescript';\n\nimport {\n  collectAppSources,\n  emitRegistryDefinitions,\n  filterRegisteredSources,\n  isTypedSource,\n  typeofImport,\n  withDocComment,\n} from '../common/sources';\nimport type { GeneratorOptions } from '../utils';\n\nconst { factory } = ts;\n\nconst REGISTRY = 'AppPolicies';\nconst CONFIG_HELPER = 'PolicyConfig';\nconst HANDLER_CONFIG_HELPER = 'PolicyHandlerConfig';\n\nconst NO_POLICY_PLACEHOLDER_COMMENT = `/*\n * The app doesn't have any policies yet.\n */\n\nexport {};\n`;\n\n/**\n * type PolicyHandlerConfig<THandler> = THandler extends (...args: infer TArgs) => unknown\n *   ? TArgs['length'] extends 0 | 1 ? undefined : 0 extends 1 & TArgs[1] ? unknown : TArgs[1]\n *   : unknown;\n *\n * type PolicyConfig<TModule> = TModule extends { default: infer TExport }\n *   ? PolicyHandlerConfig<TExport extends { handler: infer THandler } ? THandler : TExport>\n *   : unknown;\n *\n * Emitted in the file so that policies.ts stands alone, like the services and controllers helpers,\n * and only when a TypeScript policy reads them.\n *\n * Resolves the config a policy accepts from the type of its module: the second parameter of its\n * handler, for both runtime forms (a bare handler, or `{ handler, validator }`). A handler without\n * a config parameter takes none: `undefined`, as in PackagePolicies. An untyped (`any`) config and a\n * module without a default export resolve to `unknown`: one `any` entry would turn every policy\n * reference into `any`.\n * TODO @Nico a module without a default export registers nothing usable at runtime (resolving it\n * throws); `unknown` accepts any reference to it, like an untyped policy\n */\nconst generateConfigHelpersDefinition = () => {\n  const args = factory.createTypeReferenceNode('TArgs');\n  const configArg = factory.createIndexedAccessTypeNode(\n    args,\n    factory.createLiteralTypeNode(factory.createNumericLiteral(1))\n  );\n\n  const handlerConfig = factory.createConditionalTypeNode(\n    factory.createTypeReferenceNode('THandler'),\n    factory.createFunctionTypeNode(\n      undefined,\n      [\n        factory.createParameterDeclaration(\n          undefined,\n          factory.createToken(ts.SyntaxKind.DotDotDotToken),\n          'args',\n          undefined,\n          factory.createInferTypeNode(factory.createTypeParameterDeclaration(undefined, 'TArgs'))\n        ),\n      ],\n      factory.createKeywordTypeNode(ts.SyntaxKind.UnknownKeyword)\n    ),\n    factory.createConditionalTypeNode(\n      factory.createIndexedAccessTypeNode(\n        args,\n        factory.createLiteralTypeNode(factory.createStringLiteral('length', true))\n      ),\n      factory.createUnionTypeNode([\n        factory.createLiteralTypeNode(factory.createNumericLiteral(0)),\n        factory.createLiteralTypeNode(factory.createNumericLiteral(1)),\n      ]),\n      factory.createKeywordTypeNode(ts.SyntaxKind.UndefinedKeyword),\n      // 0 extends 1 & TArgs[1], true only when the config is `any`\n      factory.createConditionalTypeNode(\n        factory.createLiteralTypeNode(factory.createNumericLiteral(0)),\n        factory.createIntersectionTypeNode([\n          factory.createLiteralTypeNode(factory.createNumericLiteral(1)),\n          configArg,\n        ]),\n        factory.createKeywordTypeNode(ts.SyntaxKind.UnknownKeyword),\n        configArg\n      )\n    ),\n    factory.createKeywordTypeNode(ts.SyntaxKind.UnknownKeyword)\n  );\n\n  const unwrapHandler = factory.createConditionalTypeNode(\n    factory.createTypeReferenceNode('TExport'),\n    factory.createTypeLiteralNode([\n      factory.createPropertySignature(\n        undefined,\n        'handler',\n        undefined,\n        factory.createInferTypeNode(factory.createTypeParameterDeclaration(undefined, 'THandler'))\n      ),\n    ]),\n    factory.createTypeReferenceNode('THandler'),\n    factory.createTypeReferenceNode('TExport')\n  );\n\n  const moduleConfig = factory.createConditionalTypeNode(\n    factory.createTypeReferenceNode('TModule'),\n    factory.createTypeLiteralNode([\n      factory.createPropertySignature(\n        undefined,\n        'default',\n        undefined,\n        factory.createInferTypeNode(factory.createTypeParameterDeclaration(undefined, 'TExport'))\n      ),\n    ]),\n    factory.createTypeReferenceNode(HANDLER_CONFIG_HELPER, [unwrapHandler]),\n    factory.createKeywordTypeNode(ts.SyntaxKind.UnknownKeyword)\n  );\n\n  return [\n    withDocComment(\n      factory.createTypeAliasDeclaration(\n        undefined,\n        factory.createIdentifier(HANDLER_CONFIG_HELPER),\n        [factory.createTypeParameterDeclaration(undefined, 'THandler')],\n        handlerConfig\n      ),\n      '*\\n * Config a policy handler accepts: its second parameter, `undefined` when it has none, `unknown`\\n * when it is untyped.\\n '\n    ),\n    withDocComment(\n      factory.createTypeAliasDeclaration(\n        undefined,\n        factory.createIdentifier(CONFIG_HELPER),\n        [factory.createTypeParameterDeclaration(undefined, 'TModule')],\n        moduleConfig\n      ),\n      '*\\n * Config accepted by the policy a policy module exports, as a bare handler or as\\n * `{ handler, validator }`.\\n '\n    ),\n  ];\n};\n\n/**\n * Generate type definitions for the application's policies (global::* and api::*)\n *\n * Policies are typed from their source file, so only the ones with a source in src/policies or\n * src/api are emitted. Plugin and admin policies are left to the packages themselves\n * (Strapi.Registries.PackagePolicies), so registering application policies keeps them accepted.\n *\n * declare global {\n *   namespace Strapi {\n *     namespace Registries {\n *       interface AppPolicies {\n *         'global::<policy>': PolicyConfig<typeof import('<relative path to the source>')>;\n *         'api::<api>.<policy>': PolicyConfig<typeof import('<relative path to the source>')>;\n *         'global::<js policy>': unknown;\n *       }\n *     }\n *   }\n * }\n *\n * The import of a JS policy is an error type without `allowJs`, and one such entry turns every policy\n * reference into `any`. JS policies are registered as `unknown` without an import.\n * TODO @Nico with `allowJs`, a JSDoc-typed JS policy could register its config like a TS one\n */\nexport const generatePoliciesDefinitions = async (\n  options: GeneratorOptions = {} as GeneratorOptions\n) => {\n  const { strapi, logger, pwd: outDir } = options;\n\n  if (!outDir) {\n    throw new Error('The policies generator needs the output directory to resolve source imports');\n  }\n\n  const sources = await collectAppSources(\n    'policies',\n    { global: strapi.dirs.app.policies, api: strapi.dirs.app.api },\n    outDir,\n    logger\n  );\n  const policiesDefinitions = filterRegisteredSources(sources, strapi.policies, logger);\n\n  logger.debug(`Found ${policiesDefinitions.length} policies.`);\n\n  if (policiesDefinitions.length === 0) {\n    return { output: NO_POLICY_PLACEHOLDER_COMMENT, stats: {} };\n  }\n\n  // The helpers are only emitted when an entry reads them: `noUnusedLocals` reports unused ones\n  const output = await emitRegistryDefinitions(\n    REGISTRY,\n    policiesDefinitions.some(isTypedSource) === true ? generateConfigHelpersDefinition() : [],\n    policiesDefinitions,\n    (source) =>\n      isTypedSource(source)\n        ? factory.createTypeReferenceNode(CONFIG_HELPER, [typeofImport(source)])\n        : factory.createKeywordTypeNode(ts.SyntaxKind.UnknownKeyword)\n  );\n\n  return { output, stats: {} };\n};\n"],"names":["factory","ts","REGISTRY","CONFIG_HELPER","HANDLER_CONFIG_HELPER","NO_POLICY_PLACEHOLDER_COMMENT","generateConfigHelpersDefinition","args","createTypeReferenceNode","configArg","createIndexedAccessTypeNode","createLiteralTypeNode","createNumericLiteral","handlerConfig","createConditionalTypeNode","createFunctionTypeNode","undefined","createParameterDeclaration","createToken","SyntaxKind","DotDotDotToken","createInferTypeNode","createTypeParameterDeclaration","createKeywordTypeNode","UnknownKeyword","createStringLiteral","createUnionTypeNode","UndefinedKeyword","createIntersectionTypeNode","unwrapHandler","createTypeLiteralNode","createPropertySignature","moduleConfig","withDocComment","createTypeAliasDeclaration","createIdentifier","generatePoliciesDefinitions","options","strapi","logger","pwd","outDir","Error","sources","collectAppSources","global","dirs","app","policies","api","policiesDefinitions","filterRegisteredSources","debug","length","output","stats","emitRegistryDefinitions","some","isTypedSource","source","typeofImport"],"mappings":"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"}

package/dist/generators/services/index.d.ts

@@ -0,0 +1,35 @@
+import type { GeneratorOptions } from '../utils';
+/**
+ * Generate type definitions for the application's services (api::*)
+ *
+ * Services are typed from their source file, so only the ones with a source in src/api are emitted.
+ * Plugin and admin services are left to the packages themselves (Strapi.Registries.PackageServices).
+ *
+ * declare global {
+ *   namespace Strapi {
+ *     namespace Registries {
+ *       interface AppServices {
+ *         'api::<api>.<service>': ServiceInstance<typeof import('<relative path to the source>')>;
+ *         'api::<api>.<service>': ServiceContractOf<import('<relative path to the source>').ServiceContract>;
+ *       }
+ *       interface InferredServices {
+ *         'api::<api>.<service>': true;
+ *       }
+ *     }
+ *   }
+ * }
+ *
+ * A service whose module exports a `ServiceContract` type registers that contract; any other service
+ * registers the type its default export provides. A JS source registers as `unknown`: without
+ * `allowJs` its import is an error type. So do a service module, a default export and a contract
+ * typed `any`.
+ *
+ * `InferredServices` lists the TypeScript services registered without a contract, whose type is read
+ * from the factory itself: `Core.ServiceFactory` rejects their uid. It is not emitted when there are
+ * none.
+ */
+export declare const generateServicesDefinitions: (options?: GeneratorOptions) => Promise<{
+    output: string;
+    stats: {};
+}>;
+//# sourceMappingURL=index.d.ts.map

package/dist/generators/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/generators/services/index.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAejD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,2BAA2B,GACtC,UAAS,gBAAyC;;;EAyDnD,CAAC"}

package/dist/generators/services/index.js

@@ -0,0 +1,87 @@
+'use strict';
+
+var sources = require('../common/sources.js');
+
+const REGISTRY = 'AppServices';
+const INSTANCE_HELPER = 'ServiceInstance';
+const CONTRACT_EXPORT = 'ServiceContract';
+const CONTRACT_HELPER = 'ServiceContractOf';
+const INFERRED_REGISTRY = 'InferredServices';
+const NO_SERVICE_PLACEHOLDER_COMMENT = `/*
+ * The app doesn't have any services yet.
+ */
+
+export {};
+`;
+/**
+ * Generate type definitions for the application's services (api::*)
+ *
+ * Services are typed from their source file, so only the ones with a source in src/api are emitted.
+ * Plugin and admin services are left to the packages themselves (Strapi.Registries.PackageServices).
+ *
+ * declare global {
+ *   namespace Strapi {
+ *     namespace Registries {
+ *       interface AppServices {
+ *         'api::<api>.<service>': ServiceInstance<typeof import('<relative path to the source>')>;
+ *         'api::<api>.<service>': ServiceContractOf<import('<relative path to the source>').ServiceContract>;
+ *       }
+ *       interface InferredServices {
+ *         'api::<api>.<service>': true;
+ *       }
+ *     }
+ *   }
+ * }
+ *
+ * A service whose module exports a `ServiceContract` type registers that contract; any other service
+ * registers the type its default export provides. A JS source registers as `unknown`: without
+ * `allowJs` its import is an error type. So do a service module, a default export and a contract
+ * typed `any`.
+ *
+ * `InferredServices` lists the TypeScript services registered without a contract, whose type is read
+ * from the factory itself: `Core.ServiceFactory` rejects their uid. It is not emitted when there are
+ * none.
+ */ const generateServicesDefinitions = async (options = {})=>{
+    const { strapi, logger, pwd: outDir } = options;
+    if (!outDir) {
+        throw new Error('The services generator needs the output directory to resolve source imports');
+    }
+    const sources$1 = await sources.collectAppSources('services', {
+        api: strapi.dirs.app.api
+    }, outDir, logger);
+    const servicesDefinitions = sources.filterRegisteredSources(sources$1, strapi.services, logger);
+    logger.debug(`Found ${servicesDefinitions.length} services.`);
+    const contract = {
+        exportName: CONTRACT_EXPORT,
+        helper: CONTRACT_HELPER,
+        uids: await sources.findTypeExports(servicesDefinitions, CONTRACT_EXPORT, logger)
+    };
+    if (servicesDefinitions.length === 0) {
+        return {
+            output: NO_SERVICE_PLACEHOLDER_COMMENT,
+            stats: {}
+        };
+    }
+    const inferredUIDs = servicesDefinitions.filter(sources.isInferredSource(contract)).map(({ uid })=>uid);
+    // Each helper is only emitted when an entry reads it: `noUnusedLocals` reports an unused one
+    const output = await sources.emitRegistryDefinitions(REGISTRY, [
+        ...inferredUIDs.length > 0 ? [
+            sources.generateInstanceHelperDefinition(INSTANCE_HELPER, '*\n * Type of the service instance exposed by a service module: the return type of its default\n * export when it is a factory, the default export itself otherwise.\n ')
+        ] : [],
+        ...contract.uids.size > 0 ? [
+            sources.generateContractHelperDefinition(CONTRACT_HELPER, '*\n * Contract a service module exports as `ServiceContract`, `unknown` when it is typed `any`.\n ')
+        ] : []
+    ], servicesDefinitions, sources.instanceTypeOf(INSTANCE_HELPER, logger, contract), [
+        {
+            registry: INFERRED_REGISTRY,
+            uids: inferredUIDs
+        }
+    ]);
+    return {
+        output,
+        stats: {}
+    };
+};
+
+exports.generateServicesDefinitions = generateServicesDefinitions;
+//# sourceMappingURL=index.js.map

package/dist/generators/services/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../src/generators/services/index.ts"],"sourcesContent":["import {\n  collectAppSources,\n  emitRegistryDefinitions,\n  filterRegisteredSources,\n  findTypeExports,\n  generateContractHelperDefinition,\n  generateInstanceHelperDefinition,\n  instanceTypeOf,\n  isInferredSource,\n} from '../common/sources';\nimport type { GeneratorOptions } from '../utils';\n\nconst REGISTRY = 'AppServices';\nconst INSTANCE_HELPER = 'ServiceInstance';\nconst CONTRACT_EXPORT = 'ServiceContract';\nconst CONTRACT_HELPER = 'ServiceContractOf';\nconst INFERRED_REGISTRY = 'InferredServices';\n\nconst NO_SERVICE_PLACEHOLDER_COMMENT = `/*\n * The app doesn't have any services yet.\n */\n\nexport {};\n`;\n\n/**\n * Generate type definitions for the application's services (api::*)\n *\n * Services are typed from their source file, so only the ones with a source in src/api are emitted.\n * Plugin and admin services are left to the packages themselves (Strapi.Registries.PackageServices).\n *\n * declare global {\n *   namespace Strapi {\n *     namespace Registries {\n *       interface AppServices {\n *         'api::<api>.<service>': ServiceInstance<typeof import('<relative path to the source>')>;\n *         'api::<api>.<service>': ServiceContractOf<import('<relative path to the source>').ServiceContract>;\n *       }\n *       interface InferredServices {\n *         'api::<api>.<service>': true;\n *       }\n *     }\n *   }\n * }\n *\n * A service whose module exports a `ServiceContract` type registers that contract; any other service\n * registers the type its default export provides. A JS source registers as `unknown`: without\n * `allowJs` its import is an error type. So do a service module, a default export and a contract\n * typed `any`.\n *\n * `InferredServices` lists the TypeScript services registered without a contract, whose type is read\n * from the factory itself: `Core.ServiceFactory` rejects their uid. It is not emitted when there are\n * none.\n */\nexport const generateServicesDefinitions = async (\n  options: GeneratorOptions = {} as GeneratorOptions\n) => {\n  const { strapi, logger, pwd: outDir } = options;\n\n  if (!outDir) {\n    throw new Error('The services generator needs the output directory to resolve source imports');\n  }\n\n  const sources = await collectAppSources('services', { api: strapi.dirs.app.api }, outDir, logger);\n  const servicesDefinitions = filterRegisteredSources(sources, strapi.services, logger);\n\n  logger.debug(`Found ${servicesDefinitions.length} services.`);\n\n  const contract = {\n    exportName: CONTRACT_EXPORT,\n    helper: CONTRACT_HELPER,\n    uids: await findTypeExports(servicesDefinitions, CONTRACT_EXPORT, logger),\n  };\n\n  if (servicesDefinitions.length === 0) {\n    return { output: NO_SERVICE_PLACEHOLDER_COMMENT, stats: {} };\n  }\n\n  const inferredUIDs = servicesDefinitions.filter(isInferredSource(contract)).map(({ uid }) => uid);\n\n  // Each helper is only emitted when an entry reads it: `noUnusedLocals` reports an unused one\n  const output = await emitRegistryDefinitions(\n    REGISTRY,\n    [\n      ...(inferredUIDs.length > 0\n        ? [\n            generateInstanceHelperDefinition(\n              INSTANCE_HELPER,\n              '*\\n * Type of the service instance exposed by a service module: the return type of its default\\n * export when it is a factory, the default export itself otherwise.\\n '\n            ),\n          ]\n        : []),\n      ...(contract.uids.size > 0\n        ? [\n            generateContractHelperDefinition(\n              CONTRACT_HELPER,\n              '*\\n * Contract a service module exports as `ServiceContract`, `unknown` when it is typed `any`.\\n '\n            ),\n          ]\n        : []),\n    ],\n    servicesDefinitions,\n    instanceTypeOf(INSTANCE_HELPER, logger, contract),\n    [\n      {\n        registry: INFERRED_REGISTRY,\n        uids: inferredUIDs,\n      },\n    ]\n  );\n\n  return { output, stats: {} };\n};\n"],"names":["REGISTRY","INSTANCE_HELPER","CONTRACT_EXPORT","CONTRACT_HELPER","INFERRED_REGISTRY","NO_SERVICE_PLACEHOLDER_COMMENT","generateServicesDefinitions","options","strapi","logger","pwd","outDir","Error","sources","collectAppSources","api","dirs","app","servicesDefinitions","filterRegisteredSources","services","debug","length","contract","exportName","helper","uids","findTypeExports","output","stats","inferredUIDs","filter","isInferredSource","map","uid","emitRegistryDefinitions","generateInstanceHelperDefinition","size","generateContractHelperDefinition","instanceTypeOf","registry"],"mappings":";;;;AAYA,MAAMA,QAAAA,GAAW,aAAA;AACjB,MAAMC,eAAAA,GAAkB,iBAAA;AACxB,MAAMC,eAAAA,GAAkB,iBAAA;AACxB,MAAMC,eAAAA,GAAkB,mBAAA;AACxB,MAAMC,iBAAAA,GAAoB,kBAAA;AAE1B,MAAMC,iCAAiC,CAAC;;;;;AAKxC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BC,IACM,MAAMC,2BAAAA,GAA8B,OACzCC,OAAAA,GAA4B,EAAsB,GAAA;IAElD,MAAM,EAAEC,MAAM,EAAEC,MAAM,EAAEC,GAAAA,EAAKC,MAAM,EAAE,GAAGJ,OAAAA;AAExC,IAAA,IAAI,CAACI,MAAAA,EAAQ;AACX,QAAA,MAAM,IAAIC,KAAAA,CAAM,6EAAA,CAAA;AAClB,IAAA;IAEA,MAAMC,SAAAA,GAAU,MAAMC,yBAAAA,CAAkB,UAAA,EAAY;AAAEC,QAAAA,GAAAA,EAAKP,MAAAA,CAAOQ,IAAI,CAACC,GAAG,CAACF;AAAI,KAAA,EAAGJ,MAAAA,EAAQF,MAAAA,CAAAA;AAC1F,IAAA,MAAMS,mBAAAA,GAAsBC,+BAAAA,CAAwBN,SAAAA,EAASL,MAAAA,CAAOY,QAAQ,EAAEX,MAAAA,CAAAA;IAE9EA,MAAAA,CAAOY,KAAK,CAAC,CAAC,MAAM,EAAEH,mBAAAA,CAAoBI,MAAM,CAAC,UAAU,CAAC,CAAA;AAE5D,IAAA,MAAMC,QAAAA,GAAW;QACfC,UAAAA,EAAYtB,eAAAA;QACZuB,MAAAA,EAAQtB,eAAAA;QACRuB,IAAAA,EAAM,MAAMC,uBAAAA,CAAgBT,mBAAAA,EAAqBhB,eAAAA,EAAiBO,MAAAA;AACpE,KAAA;IAEA,IAAIS,mBAAAA,CAAoBI,MAAM,KAAK,CAAA,EAAG;QACpC,OAAO;YAAEM,MAAAA,EAAQvB,8BAAAA;AAAgCwB,YAAAA,KAAAA,EAAO;AAAG,SAAA;AAC7D,IAAA;AAEA,IAAA,MAAMC,YAAAA,GAAeZ,mBAAAA,CAAoBa,MAAM,CAACC,wBAAAA,CAAiBT,QAAAA,CAAAA,CAAAA,CAAWU,GAAG,CAAC,CAAC,EAAEC,GAAG,EAAE,GAAKA,GAAAA,CAAAA;;IAG7F,MAAMN,MAAAA,GAAS,MAAMO,+BAAAA,CACnBnC,QAAAA,EACA;WACM8B,YAAAA,CAAaR,MAAM,GAAG,CAAA,GACtB;AACEc,YAAAA,wCAAAA,CACEnC,eAAAA,EACA,yKAAA;AAEH,SAAA,GACD,EAAE;AACFsB,QAAAA,GAAAA,QAAAA,CAASG,IAAI,CAACW,IAAI,GAAG,CAAA,GACrB;AACEC,YAAAA,wCAAAA,CACEnC,eAAAA,EACA,oGAAA;AAEH,SAAA,GACD;AACL,KAAA,EACDe,mBAAAA,EACAqB,sBAAAA,CAAetC,eAAAA,EAAiBQ,MAAAA,EAAQc,QAAAA,CAAAA,EACxC;AACE,QAAA;YACEiB,QAAAA,EAAUpC,iBAAAA;YACVsB,IAAAA,EAAMI;AACR;AACD,KAAA,CAAA;IAGH,OAAO;AAAEF,QAAAA,MAAAA;AAAQC,QAAAA,KAAAA,EAAO;AAAG,KAAA;AAC7B;;;;"}

package/dist/generators/services/index.mjs

@@ -0,0 +1,85 @@
+import { collectAppSources, filterRegisteredSources, findTypeExports, isInferredSource, emitRegistryDefinitions, generateInstanceHelperDefinition, generateContractHelperDefinition, instanceTypeOf } from '../common/sources.mjs';
+
+const REGISTRY = 'AppServices';
+const INSTANCE_HELPER = 'ServiceInstance';
+const CONTRACT_EXPORT = 'ServiceContract';
+const CONTRACT_HELPER = 'ServiceContractOf';
+const INFERRED_REGISTRY = 'InferredServices';
+const NO_SERVICE_PLACEHOLDER_COMMENT = `/*
+ * The app doesn't have any services yet.
+ */
+
+export {};
+`;
+/**
+ * Generate type definitions for the application's services (api::*)
+ *
+ * Services are typed from their source file, so only the ones with a source in src/api are emitted.
+ * Plugin and admin services are left to the packages themselves (Strapi.Registries.PackageServices).
+ *
+ * declare global {
+ *   namespace Strapi {
+ *     namespace Registries {
+ *       interface AppServices {
+ *         'api::<api>.<service>': ServiceInstance<typeof import('<relative path to the source>')>;
+ *         'api::<api>.<service>': ServiceContractOf<import('<relative path to the source>').ServiceContract>;
+ *       }
+ *       interface InferredServices {
+ *         'api::<api>.<service>': true;
+ *       }
+ *     }
+ *   }
+ * }
+ *
+ * A service whose module exports a `ServiceContract` type registers that contract; any other service
+ * registers the type its default export provides. A JS source registers as `unknown`: without
+ * `allowJs` its import is an error type. So do a service module, a default export and a contract
+ * typed `any`.
+ *
+ * `InferredServices` lists the TypeScript services registered without a contract, whose type is read
+ * from the factory itself: `Core.ServiceFactory` rejects their uid. It is not emitted when there are
+ * none.
+ */ const generateServicesDefinitions = async (options = {})=>{
+    const { strapi, logger, pwd: outDir } = options;
+    if (!outDir) {
+        throw new Error('The services generator needs the output directory to resolve source imports');
+    }
+    const sources = await collectAppSources('services', {
+        api: strapi.dirs.app.api
+    }, outDir, logger);
+    const servicesDefinitions = filterRegisteredSources(sources, strapi.services, logger);
+    logger.debug(`Found ${servicesDefinitions.length} services.`);
+    const contract = {
+        exportName: CONTRACT_EXPORT,
+        helper: CONTRACT_HELPER,
+        uids: await findTypeExports(servicesDefinitions, CONTRACT_EXPORT, logger)
+    };
+    if (servicesDefinitions.length === 0) {
+        return {
+            output: NO_SERVICE_PLACEHOLDER_COMMENT,
+            stats: {}
+        };
+    }
+    const inferredUIDs = servicesDefinitions.filter(isInferredSource(contract)).map(({ uid })=>uid);
+    // Each helper is only emitted when an entry reads it: `noUnusedLocals` reports an unused one
+    const output = await emitRegistryDefinitions(REGISTRY, [
+        ...inferredUIDs.length > 0 ? [
+            generateInstanceHelperDefinition(INSTANCE_HELPER, '*\n * Type of the service instance exposed by a service module: the return type of its default\n * export when it is a factory, the default export itself otherwise.\n ')
+        ] : [],
+        ...contract.uids.size > 0 ? [
+            generateContractHelperDefinition(CONTRACT_HELPER, '*\n * Contract a service module exports as `ServiceContract`, `unknown` when it is typed `any`.\n ')
+        ] : []
+    ], servicesDefinitions, instanceTypeOf(INSTANCE_HELPER, logger, contract), [
+        {
+            registry: INFERRED_REGISTRY,
+            uids: inferredUIDs
+        }
+    ]);
+    return {
+        output,
+        stats: {}
+    };
+};
+
+export { generateServicesDefinitions };
+//# sourceMappingURL=index.mjs.map

package/dist/generators/services/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":["../../../src/generators/services/index.ts"],"sourcesContent":["import {\n  collectAppSources,\n  emitRegistryDefinitions,\n  filterRegisteredSources,\n  findTypeExports,\n  generateContractHelperDefinition,\n  generateInstanceHelperDefinition,\n  instanceTypeOf,\n  isInferredSource,\n} from '../common/sources';\nimport type { GeneratorOptions } from '../utils';\n\nconst REGISTRY = 'AppServices';\nconst INSTANCE_HELPER = 'ServiceInstance';\nconst CONTRACT_EXPORT = 'ServiceContract';\nconst CONTRACT_HELPER = 'ServiceContractOf';\nconst INFERRED_REGISTRY = 'InferredServices';\n\nconst NO_SERVICE_PLACEHOLDER_COMMENT = `/*\n * The app doesn't have any services yet.\n */\n\nexport {};\n`;\n\n/**\n * Generate type definitions for the application's services (api::*)\n *\n * Services are typed from their source file, so only the ones with a source in src/api are emitted.\n * Plugin and admin services are left to the packages themselves (Strapi.Registries.PackageServices).\n *\n * declare global {\n *   namespace Strapi {\n *     namespace Registries {\n *       interface AppServices {\n *         'api::<api>.<service>': ServiceInstance<typeof import('<relative path to the source>')>;\n *         'api::<api>.<service>': ServiceContractOf<import('<relative path to the source>').ServiceContract>;\n *       }\n *       interface InferredServices {\n *         'api::<api>.<service>': true;\n *       }\n *     }\n *   }\n * }\n *\n * A service whose module exports a `ServiceContract` type registers that contract; any other service\n * registers the type its default export provides. A JS source registers as `unknown`: without\n * `allowJs` its import is an error type. So do a service module, a default export and a contract\n * typed `any`.\n *\n * `InferredServices` lists the TypeScript services registered without a contract, whose type is read\n * from the factory itself: `Core.ServiceFactory` rejects their uid. It is not emitted when there are\n * none.\n */\nexport const generateServicesDefinitions = async (\n  options: GeneratorOptions = {} as GeneratorOptions\n) => {\n  const { strapi, logger, pwd: outDir } = options;\n\n  if (!outDir) {\n    throw new Error('The services generator needs the output directory to resolve source imports');\n  }\n\n  const sources = await collectAppSources('services', { api: strapi.dirs.app.api }, outDir, logger);\n  const servicesDefinitions = filterRegisteredSources(sources, strapi.services, logger);\n\n  logger.debug(`Found ${servicesDefinitions.length} services.`);\n\n  const contract = {\n    exportName: CONTRACT_EXPORT,\n    helper: CONTRACT_HELPER,\n    uids: await findTypeExports(servicesDefinitions, CONTRACT_EXPORT, logger),\n  };\n\n  if (servicesDefinitions.length === 0) {\n    return { output: NO_SERVICE_PLACEHOLDER_COMMENT, stats: {} };\n  }\n\n  const inferredUIDs = servicesDefinitions.filter(isInferredSource(contract)).map(({ uid }) => uid);\n\n  // Each helper is only emitted when an entry reads it: `noUnusedLocals` reports an unused one\n  const output = await emitRegistryDefinitions(\n    REGISTRY,\n    [\n      ...(inferredUIDs.length > 0\n        ? [\n            generateInstanceHelperDefinition(\n              INSTANCE_HELPER,\n              '*\\n * Type of the service instance exposed by a service module: the return type of its default\\n * export when it is a factory, the default export itself otherwise.\\n '\n            ),\n          ]\n        : []),\n      ...(contract.uids.size > 0\n        ? [\n            generateContractHelperDefinition(\n              CONTRACT_HELPER,\n              '*\\n * Contract a service module exports as `ServiceContract`, `unknown` when it is typed `any`.\\n '\n            ),\n          ]\n        : []),\n    ],\n    servicesDefinitions,\n    instanceTypeOf(INSTANCE_HELPER, logger, contract),\n    [\n      {\n        registry: INFERRED_REGISTRY,\n        uids: inferredUIDs,\n      },\n    ]\n  );\n\n  return { output, stats: {} };\n};\n"],"names":["REGISTRY","INSTANCE_HELPER","CONTRACT_EXPORT","CONTRACT_HELPER","INFERRED_REGISTRY","NO_SERVICE_PLACEHOLDER_COMMENT","generateServicesDefinitions","options","strapi","logger","pwd","outDir","Error","sources","collectAppSources","api","dirs","app","servicesDefinitions","filterRegisteredSources","services","debug","length","contract","exportName","helper","uids","findTypeExports","output","stats","inferredUIDs","filter","isInferredSource","map","uid","emitRegistryDefinitions","generateInstanceHelperDefinition","size","generateContractHelperDefinition","instanceTypeOf","registry"],"mappings":";;AAYA,MAAMA,QAAAA,GAAW,aAAA;AACjB,MAAMC,eAAAA,GAAkB,iBAAA;AACxB,MAAMC,eAAAA,GAAkB,iBAAA;AACxB,MAAMC,eAAAA,GAAkB,mBAAA;AACxB,MAAMC,iBAAAA,GAAoB,kBAAA;AAE1B,MAAMC,iCAAiC,CAAC;;;;;AAKxC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BC,IACM,MAAMC,2BAAAA,GAA8B,OACzCC,OAAAA,GAA4B,EAAsB,GAAA;IAElD,MAAM,EAAEC,MAAM,EAAEC,MAAM,EAAEC,GAAAA,EAAKC,MAAM,EAAE,GAAGJ,OAAAA;AAExC,IAAA,IAAI,CAACI,MAAAA,EAAQ;AACX,QAAA,MAAM,IAAIC,KAAAA,CAAM,6EAAA,CAAA;AAClB,IAAA;IAEA,MAAMC,OAAAA,GAAU,MAAMC,iBAAAA,CAAkB,UAAA,EAAY;AAAEC,QAAAA,GAAAA,EAAKP,MAAAA,CAAOQ,IAAI,CAACC,GAAG,CAACF;AAAI,KAAA,EAAGJ,MAAAA,EAAQF,MAAAA,CAAAA;AAC1F,IAAA,MAAMS,mBAAAA,GAAsBC,uBAAAA,CAAwBN,OAAAA,EAASL,MAAAA,CAAOY,QAAQ,EAAEX,MAAAA,CAAAA;IAE9EA,MAAAA,CAAOY,KAAK,CAAC,CAAC,MAAM,EAAEH,mBAAAA,CAAoBI,MAAM,CAAC,UAAU,CAAC,CAAA;AAE5D,IAAA,MAAMC,QAAAA,GAAW;QACfC,UAAAA,EAAYtB,eAAAA;QACZuB,MAAAA,EAAQtB,eAAAA;QACRuB,IAAAA,EAAM,MAAMC,eAAAA,CAAgBT,mBAAAA,EAAqBhB,eAAAA,EAAiBO,MAAAA;AACpE,KAAA;IAEA,IAAIS,mBAAAA,CAAoBI,MAAM,KAAK,CAAA,EAAG;QACpC,OAAO;YAAEM,MAAAA,EAAQvB,8BAAAA;AAAgCwB,YAAAA,KAAAA,EAAO;AAAG,SAAA;AAC7D,IAAA;AAEA,IAAA,MAAMC,YAAAA,GAAeZ,mBAAAA,CAAoBa,MAAM,CAACC,gBAAAA,CAAiBT,QAAAA,CAAAA,CAAAA,CAAWU,GAAG,CAAC,CAAC,EAAEC,GAAG,EAAE,GAAKA,GAAAA,CAAAA;;IAG7F,MAAMN,MAAAA,GAAS,MAAMO,uBAAAA,CACnBnC,QAAAA,EACA;WACM8B,YAAAA,CAAaR,MAAM,GAAG,CAAA,GACtB;AACEc,YAAAA,gCAAAA,CACEnC,eAAAA,EACA,yKAAA;AAEH,SAAA,GACD,EAAE;AACFsB,QAAAA,GAAAA,QAAAA,CAASG,IAAI,CAACW,IAAI,GAAG,CAAA,GACrB;AACEC,YAAAA,gCAAAA,CACEnC,eAAAA,EACA,oGAAA;AAEH,SAAA,GACD;AACL,KAAA,EACDe,mBAAAA,EACAqB,cAAAA,CAAetC,eAAAA,EAAiBQ,MAAAA,EAAQc,QAAAA,CAAAA,EACxC;AACE,QAAA;YACEiB,QAAAA,EAAUpC,iBAAAA;YACVsB,IAAAA,EAAMI;AACR;AACD,KAAA,CAAA;IAGH,OAAO;AAAEF,QAAAA,MAAAA;AAAQC,QAAAA,KAAAA,EAAO;AAAG,KAAA;AAC7B;;;;"}

package/dist/generators/strict/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Generate the opt-in to registered server contracts
+ *
+ * `@strapi/strapi/strict-types` enables strict lookups for the whole program and loads the contracts
+ * of the plugins bundled with Strapi; optional plugins are loaded by the `plugins` artifact. Going
+ * through `@strapi/strapi` keeps the application free of direct dependencies on the plugins, which
+ * it cannot resolve under a strict package manager layout.
+ */
+export declare const generateStrictDefinitions: () => Promise<{
+    output: string;
+    stats: {};
+}>;
+//# sourceMappingURL=index.d.ts.map

package/dist/generators/strict/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/generators/strict/index.ts"],"names":[],"mappings":"AAOA;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB;;;EAErC,CAAC"}

package/dist/generators/strict/index.js

@@ -0,0 +1,24 @@
+'use strict';
+
+const STRICT_OPT_IN = `/*
+ * Opts the application into registered server contracts
+ * Generated because \`typescript.strictTypes\` is enabled; disabling it removes this file.
+ */
+import type {} from '@strapi/strapi/strict-types';
+`;
+/**
+ * Generate the opt-in to registered server contracts
+ *
+ * `@strapi/strapi/strict-types` enables strict lookups for the whole program and loads the contracts
+ * of the plugins bundled with Strapi; optional plugins are loaded by the `plugins` artifact. Going
+ * through `@strapi/strapi` keeps the application free of direct dependencies on the plugins, which
+ * it cannot resolve under a strict package manager layout.
+ */ const generateStrictDefinitions = async ()=>{
+    return {
+        output: STRICT_OPT_IN,
+        stats: {}
+    };
+};
+
+exports.generateStrictDefinitions = generateStrictDefinitions;
+//# sourceMappingURL=index.js.map

package/dist/generators/strict/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../src/generators/strict/index.ts"],"sourcesContent":["const STRICT_OPT_IN = `/*\n * Opts the application into registered server contracts\n * Generated because \\`typescript.strictTypes\\` is enabled; disabling it removes this file.\n */\nimport type {} from '@strapi/strapi/strict-types';\n`;\n\n/**\n * Generate the opt-in to registered server contracts\n *\n * `@strapi/strapi/strict-types` enables strict lookups for the whole program and loads the contracts\n * of the plugins bundled with Strapi; optional plugins are loaded by the `plugins` artifact. Going\n * through `@strapi/strapi` keeps the application free of direct dependencies on the plugins, which\n * it cannot resolve under a strict package manager layout.\n */\nexport const generateStrictDefinitions = async () => {\n  return { output: STRICT_OPT_IN, stats: {} };\n};\n"],"names":["STRICT_OPT_IN","generateStrictDefinitions","output","stats"],"mappings":";;AAAA,MAAMA,gBAAgB,CAAC;;;;;AAKvB,CAAC;AAED;;;;;;;UAQaC,yBAAAA,GAA4B,UAAA;IACvC,OAAO;QAAEC,MAAAA,EAAQF,aAAAA;AAAeG,QAAAA,KAAAA,EAAO;AAAG,KAAA;AAC5C;;;;"}

package/dist/generators/strict/index.mjs

@@ -0,0 +1,22 @@
+const STRICT_OPT_IN = `/*
+ * Opts the application into registered server contracts
+ * Generated because \`typescript.strictTypes\` is enabled; disabling it removes this file.
+ */
+import type {} from '@strapi/strapi/strict-types';
+`;
+/**
+ * Generate the opt-in to registered server contracts
+ *
+ * `@strapi/strapi/strict-types` enables strict lookups for the whole program and loads the contracts
+ * of the plugins bundled with Strapi; optional plugins are loaded by the `plugins` artifact. Going
+ * through `@strapi/strapi` keeps the application free of direct dependencies on the plugins, which
+ * it cannot resolve under a strict package manager layout.
+ */ const generateStrictDefinitions = async ()=>{
+    return {
+        output: STRICT_OPT_IN,
+        stats: {}
+    };
+};
+
+export { generateStrictDefinitions };
+//# sourceMappingURL=index.mjs.map

package/dist/generators/strict/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":["../../../src/generators/strict/index.ts"],"sourcesContent":["const STRICT_OPT_IN = `/*\n * Opts the application into registered server contracts\n * Generated because \\`typescript.strictTypes\\` is enabled; disabling it removes this file.\n */\nimport type {} from '@strapi/strapi/strict-types';\n`;\n\n/**\n * Generate the opt-in to registered server contracts\n *\n * `@strapi/strapi/strict-types` enables strict lookups for the whole program and loads the contracts\n * of the plugins bundled with Strapi; optional plugins are loaded by the `plugins` artifact. Going\n * through `@strapi/strapi` keeps the application free of direct dependencies on the plugins, which\n * it cannot resolve under a strict package manager layout.\n */\nexport const generateStrictDefinitions = async () => {\n  return { output: STRICT_OPT_IN, stats: {} };\n};\n"],"names":["STRICT_OPT_IN","generateStrictDefinitions","output","stats"],"mappings":"AAAA,MAAMA,gBAAgB,CAAC;;;;;AAKvB,CAAC;AAED;;;;;;;UAQaC,yBAAAA,GAA4B,UAAA;IACvC,OAAO;QAAEC,MAAAA,EAAQF,aAAAA;AAAeG,QAAAA,KAAAA,EAAO;AAAG,KAAA;AAC5C;;;;"}