{"_id":"@flatfile/ember","_rev":"66-3f40c819687b64d86a903a0ebdf37021","name":"@flatfile/ember","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.1":{"name":"@flatfile/ember","version":"0.1.1","keywords":["ember-addon"],"author":{"name":"bestdoggo"},"license":"MIT","_id":"@flatfile/ember@0.1.1","maintainers":[{"name":"maksymblank","email":"blank.maksym@gmail.com"},{"name":"robbiet480","email":"me@robbiet.us"},{"name":"flatfile-user","email":"hello@flatfile.io"},{"name":"dboskovic","email":"me@david.gs"},{"name":"brentkulwicki","email":"brentkulwicki@gmail.com"},{"name":"nate.ferrero","email":"nateferrero@gmail.com"},{"name":"markpieszak","email":"mpieszak84@gmail.com"}],"dist":{"shasum":"a5a801c72771c0c9508d77b23a1e52b2f3280d12","tarball":"https://registry.npmjs.org/@flatfile/ember/-/ember-0.1.1.tgz","fileCount":14,"integrity":"sha512-qMLlcPR+14VLC7PIy47qRgaiMYvB8evOQQSiR6B2o9p2NYpNqVXKPuPQIDVTffieJxfg5UKjj2OZB/+U7Hi1ZA==","signatures":[{"sig":"MEUCIC9rcs+KXfTIRzOFHkLAs0+o3E8o550udBj7gWs2hZG6AiEAmn62X6WS9D8p7j+9bkhivmIU/HQ12NbaAhffIy4j5tI=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":14427,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.13\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJgYTkmCRA9TVsSAnZWagAAGOoQAIB4KB6xz0T7SxWKAs+/\n/gYiG1H4oupu2HC9au9zjsCMxWAvAEtwsB/O5JkEr7N4IfEtCJDiAvHT4dqn\n93D4R2IhNWxb6E+S+Szm5CY+7b6dNamsoUjZJRmNUSzE9GiPxlWebcU17vBe\nnMD7LztIOD6IJv73B2L7pbCwWcNHzmQz0vBZ505KkVkOCu+82jLjvmTnlfav\nXs5Fxu8dFfa3I0ECOslZmOjV37aM+UrM1RotEFtLYeCu26dGhd7af3VbQObd\nW/ToJpdyrAv1PZs2K05R/3e7Lqt2sag066+1rY2dfd8ve0wCMFrKNozcNZbn\natdOSr4zLqwc8NPiq8wOuB0AITlG3XFEc2kj6kMmyGDe8Dajd9Q17HuHxVJA\n8zO4L6Yp133uwkdqyS1PApPJYbdu6p+fd0H/hfBXLkh/JKDug/K+z9DZwX8n\n78SzTTykp6V3VGSuLtR2lmeAwVhncj0BJrt75rn9ajfxYnWo8LYesvEK4E+z\nk/wasRyJM22zgAxZzEpmIqjO0+RlU2jaGZi8J+JOAoOeExoV+bRKEJ9KhrVE\nQOM1uRYLHIkO0UTvBhrv1aeh1hO0HfK1/aYjVnEMNw641zl4Oli/Vof5AegE\nxXAtjcHy/jEP4ZMmUPafbjxsNlAwbbK5XSAW4WK2zCw+b0X5E7fif6dIlc4P\n8TKS\r\n=wPPD\r\n-----END PGP SIGNATURE-----\r\n"},"ember":{"edition":"octane"},"engines":{"node":"10.* || >= 12"},"gitHead":"c69c5146d8e00fcab27340587943fb44d9531651","scripts":{"lint":"npm-run-all --aggregate-output --continue-on-error --parallel 'lint:!(fix)'","test":"npm-run-all lint test:*","build":"ember build --environment=production","start":"ember serve","lint:js":"eslint . --cache","lint:fix":"npm-run-all --aggregate-output --continue-on-error --parallel lint:*:fix","lint:hbs":"ember-template-lint .","test:ember":"ember test","lint:js:fix":"eslint . --fix","lint:hbs:fix":"ember-template-lint . --fix","test:ember-compatibility":"ember try:each"},"_npmUser":{"name":"robbiet480","email":"me@robbiet.us"},"repository":"","_npmVersion":"6.13.4","description":"Ember Flatfile Adapter","directories":{"doc":"doc","test":"tests"},"ember-addon":{"configPath":"tests/dummy/config"},"_nodeVersion":"10.19.0","dependencies":{"ember-cli-babel":"^7.23.1","@flatfile/adapter":"^2.6.1","ember-auto-import":"^1.10.1","ember-cli-htmlbars":"^5.3.2"},"_hasShrinkwrap":false,"devDependencies":{"qunit":"^2.14.0","eslint":"^7.20.0","prettier":"^2.2.1","ember-cli":"~3.25.2","ember-try":"^1.4.0","loader.js":"^4.7.0","qunit-dom":"^1.6.0","ember-qunit":"^5.1.2","ember-sinon":"^5.0.0","npm-run-all":"^4.1.5","babel-eslint":"^10.1.0","ember-source":"~3.25.1","ember-cli-sri":"^2.1.1","ember-resolver":"^8.0.2","ember-cli-terser":"^4.0.1","ember-page-title":"^6.2.1","@glimmer/tracking":"^1.0.3","ember-sinon-qunit":"^5.0.0","@glimmer/component":"^1.0.3","broccoli-asset-rev":"^3.0.0","eslint-plugin-node":"^11.1.0","@ember/test-helpers":"^2.2.0","ember-template-lint":"^2.18.1","eslint-plugin-ember":"^10.2.0","eslint-config-prettier":"^7.2.0","eslint-plugin-prettier":"^3.3.1","ember-load-initializers":"^2.1.2","@ember/optional-features":"^2.0.0","ember-source-channel-url":"^3.0.0","ember-cli-dependency-checker":"^3.2.0","ember-cli-inject-live-reload":"^2.0.2","ember-maybe-import-regenerator":"^0.1.6","ember-export-application-global":"^2.0.1","ember-disable-prototype-extensions":"^1.1.3"},"_npmOperationalInternal":{"tmp":"tmp/ember_0.1.1_1616984357643_0.7112960401802224","host":"s3://npm-registry-packages"}}},"time":{"created":"2021-03-29T02:19:17.400Z","modified":"2026-04-23T23:54:13.295Z","0.1.1":"2021-03-29T02:19:17.793Z"},"author":{"name":"bestdoggo"},"license":"MIT","keywords":["ember-addon"],"description":"Ember Flatfile Adapter","maintainers":[{"email":"sam@sarocu.com","name":"sarocu"},{"email":"me@david.gs","name":"dboskovic"},{"email":"me@alexjrock.com","name":"bangarang"},{"email":"carlbrugger@proton.me","name":"carlbrugger"},{"email":"infra@flatfile.io","name":"flatfileinfra"},{"email":"derek@flatfile.io","name":"flatderek"},{"email":"eric@flatfile.io","name":"bigcountrycrane"},{"email":"matthew.e.mccoy@gmail.com","name":"mmccooyyy"},{"email":"matthew.gerstman@obvious.ai","name":"matthew-obvious"},{"email":"nikolazaris@gmail.com","name":"nlazaris"},{"email":"lion.hummer@gmail.com","name":"lionhummer"},{"email":"alexpoddubny@googlemail.com","name":"apoddubn"}],"readme":"# The Flatfile Component - @flatfile/ember\n\nWe've made it really simple for you to get started with Flatfile with our new Flatfile Component. Here's what you'll need to know to get started.\n\nFirst, install the dependency via npm:\n\n`ember install @flatfile/ember`\n\nThis will give you access to the `<FlatfileButton />` component as well as the same basic functionality as our Adapter.\n\n## FlatfileButton usage\n\n```hbs\n<FlatfileButton\n  @licenseKey=\"License Key Here\"\n  @customer={{hash userId=\"12345\"}}\n  @settings={{hash\n    type=\"Contract\"\n    fields=(array\n      (hash label=\"Full Name\" key=\"name\")\n      (hash label=\"Email\" key=\"name\")\n    )\n  }}>\n  Import Contacts\n</FlatfileButton>\n```\n\n| **<u>FlatfileButton Arguments</u>**                                                                                         | **<u>Info</u>**               | <u>**Example**</u>                     |\n| ----------------------------------------------------------------------------------------------------------------------- | ----------------------------- | -------------------------------------- |\n|`licenseKey` - Your Flatfile license key can be found in your dashboard when you [login here](https://app.flatfile.io/login).|**Required**. <br /> _string_ | `licenseKey={'ah12-alksjs2738-shdkaj123'}` |\n|`customer` - Refers to the _[setCustomer function](https://developers.flatfile.io/docs/sdk/classes/flatfileimporter#setcustomer)_. | **Required**. <br /> _object_ - [_CustomerObject_](https://developers.flatfile.io/docs/sdk/interfaces/customerobject) | `customer={{` <br />`usedId: \"1234\",`<br />`companyId: \"12\",`<br />` companyName: \"ABC\",`<br />`email: \"john@doe.com\",`<br />`name: \"John Doe\"`<br />`}}`|\n|`settings` - This is where you will pass your [Flatfile settings/options](https://developers.flatfile.io/docs/options). | **Required**. <br />_object_ | `settings={{ `<br /> `type: \"Customers\", fields: [` <br /> `{key: \"name\", label: \"Name\"}, {key: \"email\", label: \"Email\"}`<br />`]}}` |\n|`onCancel` - An optional callback for handling a user cancelling.|Optional. <br /> _function - callback_| `onCancel={() => { // do something }}`|\n|`onInteractionEvent` - An optional way to use `registerInteractionEventCallback` to receive user interaction events. By default, the `onInteractionEvent` function will be called every 5 seconds, as long as there is user activity inside of Flatfile Portal.|Optional. <br />_function_| `onInteractionEvent={({mousemove, mousedown, keydown}) => // do something}`|\n|`onBeforeFetch` - An optional callback called before fetching | Optional. <br />_function_ | `onBeforeFetch={() => { // do something}` |\n|`onData`- An optional way to use [FlatfileResults](https://developers.flatfile.io/docs/sdk/classes/flatfileresults) to return a new Promise.|Optional. <br />_function_| `onData={async results => // do something}`|\n|`onRecordChange`- An optional way to use [registerRecordHook](https://developers.flatfile.io/docs/datahooks#record-hooks-row-hooks) when a record changes.| Optional. <br /> _function_ |`onRecordChange={(data, index) => `[`IDataHookResponse`](https://developers.flatfile.io/docs/sdk/interfaces/idatahookresponse) &#124; `Promise<`[`IDataHookResponse`](https://developers.flatfile.io/docs/sdk/interfaces/idatahookresponse)`>}`|\n|`onRecordInit`- An optional way to use [registerRecordHook](https://developers.flatfile.io/docs/datahooks#record-hooks-row-hooks) on initialization.|Optional. <br />_function_|_`onRecordInit={(data, index) => `[`IDataHookResponse`](https://developers.flatfile.io/docs/sdk/interfaces/idatahookresponse) &#124; `Promise<`[`IDataHookResponse`](https://developers.flatfile.io/docs/sdk/interfaces/idatahookresponse)`>}`_|\n|`fieldHooks`- An optional way to pass in one or more callback functions to use with [registerFieldHook](https://developers.flatfile.io/docs/datahooks#field-hooks-column-hooks).|Optional. <br />object function(s) - callback(s)|`fieldHooks={`<br />`fieldName: (values) => { return // [`[`IDataHookRecord`](https://developers.flatfile.io/docs/sdk/interfaces/idatahookresponse/)`, index][]}`|\n|`preload`- An optional flag that can be set to `false` to delay loading the importer until the button is clicked. Useful in situations where there is more than one `<FlatfileButton/>` instance on a single page or minimizing page load size is important. Default is `true`.|Optional. <br />boolean |`preload={false}`|\n\nThe component also yields out the component state to allow handling of loading states how you wish.\n\n```hbs\n  as | flatfileState |>\n```\n\n| **<u>FlatfileButton Yields</u>**                                                                                        | **<u>Info</u>**               | <u>**Example**</u>                     |\n| ----------------------------------------------------------------------------------------------------------------------- | ----------------------------- | -------------------------------------- |\n|`isLoading` - start true if the preload argument is true, otherwise is false until loading starts | _boolean_ | `flatfileState.isLoading` |\n|`isReady` - starts false, becomes true when Flatfile has been initialized and loaded | _boolean_ | `flatfileState.isReady` |\n\n## FlatfileProvider usage\n\n```hbs\n<FlatfileProvider\n  @licenseKey=\"License Key Here\"\n  @customer={{hash userId=\"12345\"}}\n  @settings={{hash\n    type=\"Contract\"\n    fields=(array\n      (hash label=\"Full Name\" key=\"name\")\n      (hash label=\"Email\" key=\"name\")\n    )\n  }} as | flatfile |>\n  <a href=\"#\" {{on \"click\" flatfile.open}}>\n    FlatfileProvider with html anchor link\n  </a>\n</FlatfileProvider>\n```\n\nAll of the same component arguments are available for FlatfileProvider as are available above for FlatfileButton.\n\nThe component also yields out the component state to allow handling of loading states how you wish.\n\n```hbs\n  as | flatfile |>\n```\n\n| **<u>FlatfileProvider Yields</u>**                                                                                        | **<u>Info</u>**               | <u>**Example**</u>                     |\n| ----------------------------------------------------------------------------------------------------------------------- | ----------------------------- | -------------------------------------- |\n|`flatfile.open` - can be tied to an event to open the flatfile importer, this is the default click event for FlatfileButton | _action_ or _function_ | `{{on \"click\" flatfile.open}}` |\n|`flatfile.state.isLoading` - start true if the preload argument is true, otherwise is false until loading starts | _boolean_ | `flatfile.state.isLoading` |\n|`flatfile.state.isReady` - starts false, becomes true when Flatfile has been initialized and loaded | _boolean_ | `flatfile.state.isReady` |\n","readmeFilename":"README.md"}