@c8y/devkit 1019.0.3

package/README.md

@@ -0,0 +1,13 @@
+**`@c8y/devkit` Package Overview**
+
+The `@c8y/devkit` package is an essential toolkit for developers working with Cumulocity applications, designed to facilitate the migration from `@c8ycli` to `ng cli`. Here's what it offers:
+
+1. **Easy App Initialization**: Streamlines new application setup with `ng add @c8y/websdk`, handling app naming and versioning.
+
+2. **Custom Webpack Configuration**: Integrates a specialized webpack configuration, accommodating the unique needs of hybrid Cumulocity applications while aligning with standard Angular setups.
+
+3. **Enhanced Development Tools**: Includes custom builders like `browser` for building apps, `dev-server` for local development, and `deploy` for deploying apps to tenants.
+
+4. **Locale Management**: Offers tools for extracting and compiling locales, aiding in the translation process and integration of language files.
+
+This toolkit is designed to make your development experience with Cumulocity applications more efficient, streamlined, and up-to-date with the latest Angular practices.

package/dist/builders.json

@@ -0,0 +1,29 @@
+{
+  "builders": {
+    "build": {
+      "implementation": "./src/builders/browser",
+      "schema": "./src/builders/browser/schema.json",
+      "description": "Build application"
+    },
+    "dev-server": {
+      "implementation": "./src/builders/dev-server",
+      "schema": "./src/builders/dev-server/schema.json",
+      "description": "Development server"
+    },
+    "deploy": {
+      "implementation": "./src/builders/deploy/deploy-builder",
+      "schema": "./src/builders/deploy/schema.json",
+      "description": "Deploy application to tenant"
+    },
+    "extract-i18n": {
+      "implementation": "./src/builders/extract-i18n/extract-i18n-builder",
+      "schema": "./src/builders/extract-i18n/schema.json",
+      "description": "Extracts all strings for translation"
+    },
+    "compile-i18n": {
+      "implementation": "./src/builders/compile-i18n/compile-i18n-builder",
+      "schema": "./src/builders/compile-i18n/schema.json",
+      "description": "Compiles .po files into json files"
+    }
+  }
+}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * as browse from './src/builders/browser';
+export * as devServer from './src/builders/dev-server';
+export * as deploy from './src/builders/deploy/deploy-builder';
+export * as extractI18n from './src/builders/extract-i18n/extract-i18n-builder';
+export * as compileI18n from './src/builders/compile-i18n/compile-i18n-builder';
+export * from './src/schematics/ng-add/index';

package/dist/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compileI18n = exports.extractI18n = exports.deploy = exports.devServer = exports.browse = void 0;
+const tslib_1 = require("tslib");
+exports.browse = require("./src/builders/browser");
+exports.devServer = require("./src/builders/dev-server");
+exports.deploy = require("./src/builders/deploy/deploy-builder");
+exports.extractI18n = require("./src/builders/extract-i18n/extract-i18n-builder");
+exports.compileI18n = require("./src/builders/compile-i18n/compile-i18n-builder");
+tslib_1.__exportStar(require("./src/schematics/ng-add/index"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;;AAAA,mDAAiD;AACjD,yDAAuD;AACvD,iEAA+D;AAC/D,kFAAgF;AAChF,kFAAgF;AAChF,wEAA8C"}

package/dist/options.d.ts

@@ -0,0 +1,2 @@
+export * from './src/webpack/EnvironmentOptions';
+export * from './src/webpack/ApplicationOptions';

package/dist/options.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./src/webpack/EnvironmentOptions"), exports);
+tslib_1.__exportStar(require("./src/webpack/ApplicationOptions"), exports);
+//# sourceMappingURL=options.js.map

package/dist/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../options.ts"],"names":[],"mappings":";;;AAAA,2EAAiD;AACjD,2EAAiD"}

package/dist/src/builders/BuilderOptions.d.ts

@@ -0,0 +1,90 @@
+import { BrowserBuilderOptions, DevServerBuilderOptions } from '@angular-devkit/build-angular';
+import { EnvironmentOptions } from '../webpack/EnvironmentOptions';
+/**
+ * Interface representing the configuration options for the builder.
+ * It extends the JsonObject type, which represents a JSON-serializable object.
+ */
+export interface C8yDevServerBuilderOptions extends EnvironmentOptions, DevServerBuilderOptions {
+    /**
+     * Optional property representing the target URL for the proxy.
+     * If specified, the builder will set up a proxy that forwards requests
+     * to this URL.
+     * Url is received via -u flag when running dev server with ng cli.
+     */
+    url: string;
+    /**
+     * An application where the current module federation modules should be tried out.
+     */
+    shell: string;
+}
+export interface C8yBrowserBuilderOptions extends EnvironmentOptions, BrowserBuilderOptions {
+}
+export interface C8yDeployBuilderOptions extends EnvironmentOptions, BrowserBuilderOptions {
+    /**
+     * Property representing the target URL for deploying the app.
+     * Url is received via -u flag when running deploy with ng cli.
+     */
+    url: string;
+    /**
+     * Tenant user login.
+     * User login is received via -U flag when running deploy with ng cli.
+     */
+    user: string;
+    /**
+     * Tenant user password.
+     * Password is received via -P flag when running deploy with ng cli.
+     */
+    password: string;
+    /**
+     * Tenant id.
+     * Tenant id is received via -T flag when running deploy with ng cli.
+     */
+    tenant?: string;
+    /**
+     * Path to already zipped application. Property is optional. If not provided, application will be built, zipped and
+     * deployed.
+     * Zip path is received via -z flag when running deploy with ng cli.
+     */
+    zipPath?: string;
+    /**
+     * Tags for package applications. To provide multiple tags, they should be separated by ",".
+     * Tags are received via  -t flag when running deploy with ng cli.
+     */
+    tags?: string;
+    /**
+     * Property responsible for picking right configuration (development, production) for build.
+     * Browser target is not provided in command as a flag. Instead, configuration is, with via flag -c.
+     */
+    browserTarget?: string;
+}
+export interface C8yExtractI18nBuilderOptions {
+    /**
+     * Output directory for the generated .po files.
+     * Output is received via -o flag when running extract-i18n with ng cli.
+     */
+    output?: string;
+    /**
+     * Include source line references.
+     * Refs is received via -r flag when running extract-i18n with ng cli.
+     * It needs no explicit value in command line- parameter will be `true` if flag is provided and `false` if omitted.
+     */
+    refs?: boolean;
+    /**
+     * Glob patterns list to extract locales from.
+     * Paths property is received via -p flag when running extract-i18n with ng cli.
+     */
+    paths?: string[];
+}
+export interface C8yCompileI18nBuilderOptions {
+    /**
+     * Output path for the generated json files.
+     * Output is received via -o flag when running compile-i18n with ng cli.
+     */
+    output?: string;
+    /**
+     * Glob patterns list to compile locales from.
+     * Paths property is received via -p flag when running compile-i18n with ng cli.
+     * Property is optional, but schema for this builder ensures that builder gets empty array if no values provided.
+     */
+    paths: string[];
+}

package/dist/src/builders/BuilderOptions.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=BuilderOptions.js.map

package/dist/src/builders/BuilderOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BuilderOptions.js","sourceRoot":"","sources":["../../../src/builders/BuilderOptions.ts"],"names":[],"mappings":""}

package/dist/src/builders/browser/index.d.ts

@@ -0,0 +1,2 @@
+declare const builder: unknown;
+export default builder;

package/dist/src/builders/browser/index.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const architect_1 = require("@angular-devkit/architect");
+const lodash_1 = require("lodash");
+const base_1 = require("../../webpack/config/base");
+const build_angular_1 = require("@angular-devkit/build-angular");
+// Sadly the `Builder` interface is not exported by @angular-devkit/architect
+const builder = (0, architect_1.createBuilder)(buildBuilder);
+exports.default = builder;
+function buildBuilder(options, context) {
+    const cleanedOptions = (0, lodash_1.omitBy)(options, lodash_1.isUndefined);
+    const webpackConfig = (0, base_1.webpackConfigurationTransformerWithContext)(cleanedOptions, context);
+    return (0, build_angular_1.executeBrowserBuilder)(cleanedOptions, context, {
+        webpackConfiguration: webpackConfig
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/src/builders/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/builders/browser/index.ts"],"names":[],"mappings":";;AAAA,yDAA0E;AAC1E,mCAA6C;AAC7C,oDAAuF;AACvF,iEAAsE;AAGtE,6EAA6E;AAC7E,MAAM,OAAO,GAAY,IAAA,yBAAa,EAAC,YAAY,CAAC,CAAC;AACrD,kBAAe,OAAO,CAAC;AAEvB,SAAS,YAAY,CAAC,OAAiC,EAAE,OAAuB;IAC9E,MAAM,cAAc,GAAG,IAAA,eAAM,EAAC,OAAO,EAAE,oBAAW,CAA6B,CAAC;IAChF,MAAM,aAAa,GAAG,IAAA,iDAA0C,EAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IAE1F,OAAO,IAAA,qCAAqB,EAAC,cAAc,EAAE,OAAO,EAAE;QACpD,oBAAoB,EAAE,aAAa;KACpC,CAAC,CAAC;AACL,CAAC"}